# Quality Assurance Checklist

**Last Updated:** 2026-01-11  
**Purpose:** Comprehensive QA checklist for blog post manual review completion

## Pre-Review Checklist

### Documentation Files

- [ ] All 4 documentation files exist:
  - [ ] `POST_ANALYSIS.md`
  - [ ] `SEO_REPORT.md`
  - [ ] `INTERNAL_LINKS.md`
  - [ ] `IMPROVEMENT_PLAN.md` (Ratgeber/Lexikon only)

### Automated Placeholders

- [ ] Run `php v2/scripts/blog/validate-placeholder-completion.php --post={slug} --category={category}`
- [ ] All automated placeholders filled (SEO_SCORE, REPORT_TIMESTAMP, GA4/GSC data)
- [ ] No errors in placeholder validation

### Data Files

- [ ] `data/seo-analysis.json` exists and is valid
- [ ] `data/related-resources.json` exists and is valid
- [ ] `data/performance-ga4.json` exists (if available)
- [ ] `data/performance-gsc.json` exists (if available)

## Manual Review Completion Checklist

### POST_ANALYSIS.md

- [ ] Manual Notes section completed with content overview
- [ ] Additional Manual Observations completed (2+ observations)
- [ ] Manual Strengths Identified (2+ strengths)
- [ ] Manual Weaknesses Identified (2+ weaknesses)
- [ ] Manual Improvement Priorities completed:
  - [ ] High Priority (2+ items)
  - [ ] Medium Priority (1+ item)
  - [ ] Low Priority (1+ item)

### SEO_REPORT.md

- [ ] Manual SEO Notes completed with current performance
- [ ] Manual SEO Observations completed (2+ observations)
- [ ] Manual SEO Improvement Priorities completed:
  - [ ] High Priority (2+ items)
  - [ ] Medium Priority (1+ item)
  - [ ] Low Priority (1+ item)

### INTERNAL_LINKS.md

- [ ] Manual Link Notes completed with current status
- [ ] Manual Link Observations completed (2+ observations)
- [ ] Manual Link Improvement Priorities completed:
  - [ ] High Priority (2+ items)
  - [ ] Medium Priority (1+ item)
  - [ ] Low Priority (1+ item)

### IMPROVEMENT_PLAN.md (Ratgeber/Lexikon only)

- [ ] Manual Improvement Notes completed with overall assessment
- [ ] Manual Improvement Observations completed (2+ observations)
- [ ] Manual Improvement Priorities completed:
  - [ ] High Priority (2+ items)
  - [ ] Medium Priority (1+ item)
  - [ ] Low Priority (1+ item)

## Content Quality Checklist

### Word Count

- [ ] Word count meets target (1,200+ for Ratgeber/Lexikon, 800+ for Inside Ordio)
- [ ] If below target, expansion plan documented in IMPROVEMENT_PLAN.md

### FAQ Coverage

- [ ] FAQ section present (target: 5-10 FAQs)
- [ ] FAQ schema markup implemented
- [ ] FAQs address common search queries

### Internal Linking

- [ ] Minimum 10 internal links (target)
- [ ] Links include mix of:
  - [ ] Blog post links (5+)
  - [ ] Tool/template links (2-5)
  - [ ] Pillar page links (1+)
- [ ] Link quality score documented
- [ ] Link improvement plan in INTERNAL_LINKS.md

### SEO Optimization

- [ ] SEO score documented
- [ ] Meta title optimized (50-60 chars)
- [ ] Meta description optimized (150-160 chars)
- [ ] Primary keyword in title and H2 headings
- [ ] Schema markup implemented (Article, FAQ, Breadcrumb)

## Validation Checklist

### Placeholder Validation

- [ ] Run `php v2/scripts/blog/validate-placeholder-completion.php --post={slug} --category={category}`
- [ ] All placeholders completed (✅ Complete status)
- [ ] No remaining placeholders

### Quality Validation

- [ ] Run `php v2/scripts/blog/validate-documentation-quality.php --post={slug} --category={category}`
- [ ] Quality score documented
- [ ] Issues identified and documented

### Progress Tracking

- [ ] Run `php v2/scripts/blog/generate-review-progress-tracker.php`
- [ ] Post marked as completed in tracker
- [ ] Progress updated

## Post-Review Checklist

### Documentation Completeness

- [ ] All manual sections completed
- [ ] No placeholder text remaining (`{PLACEHOLDER_NAME}`)
- [ ] All observations are specific and actionable
- [ ] Improvement priorities are prioritized correctly

### Consistency Check

- [ ] Manual notes align across all 4 files
- [ ] Improvement priorities are consistent
- [ ] Link opportunities match related-resources.json
- [ ] SEO observations match seo-analysis.json

### Final Validation

- [ ] All checkboxes in this checklist completed
- [ ] Post ready for content improvements
- [ ] Documentation serves as actionable improvement plan

## Notes

- Use this checklist for each post after completing manual placeholders
- Mark items as complete only when fully satisfied
- Document any exceptions or special cases
- Update checklist if new requirements emerge