# FAQ Manual Review Checklist

**Last Updated:** 2026-01-14

Comprehensive checklist for manually reviewing FAQ answers to ensure quality, SEO optimization, and user value.

## Pre-Review Setup

- [ ] Load post data (title, primary keyword, related keywords)
- [ ] Review post content to understand context
- [ ] Check primary keyword is correct (not a fragment like "Gibt es ein")
- [ ] Run comprehensive analysis: `php v2/scripts/blog/comprehensive-faq-analysis.php --post=slug --category=category`
- [ ] Run topic relevance check: `php v2/scripts/blog/validate-faq-topic-relevance.php --post=slug --category=category`
- [ ] Run pattern detection: `php v2/scripts/blog/detect-faq-patterns.php --post=slug --category=category`
- [ ] Run ordering analysis: `php v2/scripts/blog/analyze-faq-ordering.php --post=slug --category=category`
- [ ] Verify FAQ questions are grammatically correct and make sense

## Quality Checklist (Per FAQ)

### 0. Topic Relevance (CRITICAL)

- [ ] **FAQ question relates to post topic** (relevance ≥ 0.3)
- [ ] Question is not off-topic
- [ ] No brand questions on non-brand posts (unless naturally relevant)
- [ ] Question makes sense in context of post

**Check relevance score from analysis - remove if < 0.3**

### 1. Pattern Detection (CRITICAL)

- [ ] **No nonsensical cost patterns** ("Was kostet [abstract concept]?")
- [ ] **No nonsensical duration patterns** ("Wie lange dauert [abstract concept]?")
- [ ] **No malformed questions** (fragments, multiple question marks)
- [ ] Question is grammatically correct and complete

**Examples to remove:**

- ❌ "Was kostet Freizeitausgleich?" (abstract concept doesn't have cost)
- ❌ "Wie lange dauert beispiele?" (abstract concept has no duration)
- ❌ "Was ist Überstunden erfassen: Vergütung,?" (malformed fragment)

### 2. Duplicate Detection (CRITICAL)

- [ ] **No duplicate questions** (similarity < 0.7 with other FAQs)
- [ ] Question is unique (not variation of existing question)
- [ ] No redundant questions asking same thing differently

**Check for duplicates:**

- "Was ist Accord-Arbeit?" vs "Was ist Accordarbeit?" vs "Was ist Akkord-Arbeit?" (all same, keep one)

### 3. Ordering (IMPORTANT)

- [ ] **FAQs follow logical flow** (definitions before how-to)
- [ ] High-volume queries appear first (if GSC data available)
- [ ] Related questions grouped together
- [ ] Not randomly scattered

**Ideal order:**

1. Definitions ("Was ist...?")
2. How-to ("Wie funktioniert...?")
3. Requirements ("Was muss ich...?")
4. Details/Edge cases

### 4. Primary Keyword Integration

- [ ] **Primary keyword appears naturally** in the answer (at least 1x)
- [ ] Keyword is integrated naturally, not forced
- [ ] Keyword appears in context, not just at the beginning
- [ ] If keyword is missing, mark for regeneration

### 5. Answer Length

- [ ] Answer is **40-80 words** (target: 55-65 words)
- [ ] Answer is not too short (< 40 words) - lacks detail
- [ ] Answer is not too long (> 80 words) - loses focus
- [ ] Word count is appropriate for the question complexity

### 6. Content Quality

- [ ] **Answers the question directly** in the first sentence
- [ ] Provides relevant context and details
- [ ] Includes actionable information if applicable
- [ ] No template language ("Wichtig ist, dass...", "Für detaillierte Informationen...")
- [ ] No generic phrases without value
- [ ] No repetitive content
- [ ] Natural German language (du tone)
- [ ] Professional but accessible tone

### 7. Keyword Integration

- [ ] Primary keyword present and natural
- [ ] Related keywords used where relevant
- [ ] LSI keywords integrated for semantic richness
- [ ] Keywords don't feel forced or spammy

### 8. HTML Formatting

- [ ] Answer uses proper `<p>` tags
- [ ] No question tags in answer (`<p><strong>Frage:</strong>`)
- [ ] No label tags (`Handlungsempfehlung:`, `Antwort:`)
- [ ] Clean, semantic HTML structure

### 9. Ordio Mention (Optional)

- [ ] Ordio mentioned only if naturally relevant
- [ ] Maximum 1 mention per answer
- [ ] Provides value, not just promotion
- [ ] If not relevant, no Ordio mention is fine

### 10. AEO/GEO Optimization

- [ ] Answer structured for AI search engines
- [ ] Sufficient context for generative AI
- [ ] Direct, factual answers
- [ ] Clear structure (direct answer → context → action)

## Common Issues to Watch For

### Critical Issues (Must Fix)

1. **Off-Topic FAQs**

   - FAQ doesn't relate to post topic (relevance < 0.3)
   - Examples: "Was ist ordio erfahrungen?" on post about "ueberstunden-erfassen"
   - Action: Remove FAQ, replace with topic-relevant FAQ if needed

2. **Pattern Violations**

   - Nonsensical patterns: "Was kostet Freizeitausgleich?", "Wie lange dauert beispiele?"
   - Brand questions on non-brand posts: "Was ist ordio support?" on non-Ordio post
   - Malformed questions: "Was ist Überstunden erfassen: Vergütung,?"
   - Action: Remove high-severity violations, fix malformed questions

3. **Duplicate Questions**

   - Multiple questions asking same thing: "Was ist Accord-Arbeit?" vs "Was ist Accordarbeit?"
   - Similarity > 0.7 between questions
   - Action: Keep best FAQ, remove duplicates

4. **Missing Primary Keyword**

   - Answer doesn't contain the primary keyword
   - Action: Regenerate answer

5. **Malformed Questions**

   - Questions like "Was ist Gibt es ein?"
   - Action: Regenerate questions first, then answers

6. **Wrong Primary Keyword**

   - Keyword is a fragment ("Gibt es ein" instead of "dienstplan gesetz")
   - Action: Fix keyword first, then regenerate

7. **Random Ordering**
   - FAQs not following logical flow
   - Definitions scattered throughout
   - Action: Reorder following logical flow (definitions → how-to → details)

### Quality Issues (Should Fix)

1. **Template Language**

   - Phrases like "Wichtig ist, dass...", "Für detaillierte Informationen..."
   - Action: Edit or regenerate

2. **Too Short/Long**

   - Under 40 words or over 80 words
   - Action: Regenerate with length requirements

3. **Repetitive Content**

   - Same information repeated
   - Action: Edit or regenerate

4. **Generic Answers**
   - Could apply to any post
   - Action: Regenerate with more context

## Review Workflow

1. **Start Review Session**

   ```bash
   # Comprehensive analysis first
   php v2/scripts/blog/comprehensive-faq-analysis.php --post=slug --category=category

   # Interactive review
   php v2/scripts/blog/review-faq-quality-post-by-post.php --post=slug --category=category
   ```

2. **For Each FAQ:**

   - Read question and answer
   - Check quality indicators
   - Use checklist above
   - Choose action: Approve, Edit, Regenerate, Skip, Delete

3. **After Review:**
   - Add approved FAQs to post
   - Validate schema
   - Test display

## Review Actions

- **[a] Approve**: FAQ meets all quality standards
- **[e] Edit**: Minor edits needed (edit JSON manually)
- **[r] Regenerate**: Answer needs complete regeneration
- **[s] Skip**: Review later (not urgent)
- **[d] Delete**: FAQ is not useful or duplicate

## Post-Review Steps

- [ ] Add approved FAQs to post JSON
- [ ] Validate FAQPage schema
- [ ] Test FAQ display on page
- [ ] Update review progress tracking
- [ ] Document any issues found

## Quality Standards Summary

**Must Have:**

- **Topic relevance ≥ 0.3** (all FAQs relate to post topic)
- **No pattern violations** (no nonsensical patterns)
- **No duplicates** (similarity < 0.7)
- **Logical ordering** (definitions before how-to)
- Primary keyword present
- 40-80 words
- Answers question directly
- No template language
- Clean HTML
- No malformed questions

**Should Have:**

- Related keywords integrated
- LSI keywords for semantic richness
- Actionable information
- Natural Ordio mention (if relevant)

**Nice to Have:**

- GSC performance data considered
- PAA questions addressed
- Internal linking opportunities

## Examples

### Good FAQ Answer

**Question:** Was ist ein Dienstplan?

**Answer:** Ein Dienstplan ist ein strukturiertes System der Personaleinsatzplanung, das die Arbeitszeiten der Mitarbeiter in einem Unternehmen organisiert und verwaltet. Er legt fest, wer wann und wo arbeiten soll und muss die Vorgaben des Arbeitszeitgesetzes beachten. Mit Ordio kannst du Dienstpläne digital erstellen und gesetzeskonform verwalten.

**Why it's good:**

- ✓ Primary keyword "Dienstplan" appears naturally (3x)
- ✓ 58 words (within target)
- ✓ Direct answer in first sentence
- ✓ Provides context
- ✓ Natural Ordio mention
- ✓ No template language

### Bad FAQ Answer

**Question:** Was ist Gibt es ein?

**Answer:** Technisch gesehen gibt es kein spezielles Dienstplan Gesetz im deutschen Recht. Was wir jedoch haben, ist das Arbeitszeitgesetz (ArbZG), welches den Rahmen für die Arbeitszeiten und Ruhepausen von Arbeitnehmern setzt.

**Why it's bad:**

- ✗ Malformed question (contains fragment)
- ✗ Primary keyword "Gibt es ein" is wrong
- ✗ Template phrase "Technisch gesehen"
- ✗ Generic answer
- ✗ Missing actionable information

## Resources

**Analysis Tools:**

- **Comprehensive Analysis:** `v2/scripts/blog/comprehensive-faq-analysis.php`
- **Topic Relevance:** `v2/scripts/blog/validate-faq-topic-relevance.php`
- **Pattern Detection:** `v2/scripts/blog/detect-faq-patterns.php`
- **Ordering Analysis:** `v2/scripts/blog/analyze-faq-ordering.php`

**Review Tools:**

- **Quality Review:** `v2/scripts/blog/review-faq-quality-post-by-post.php`
- **Manual Review:** `v2/scripts/blog/review-faq-manually.php`

**Fix Tools:**

- **Automated Fixes:** `v2/scripts/blog/fix-faq-quality-issues.php` (with manual review)

**Other Tools:**

- **Regeneration:** `v2/scripts/blog/regenerate-post-faqs.php`
- **Quality Check:** `v2/scripts/blog/enhance-faq-quality.php`

**Documentation:**

- **Workflow Guide:** `FAQ_CREATION_WORKFLOW_2026.md`
- **Quality Guide:** `FAQ_QUALITY_IMPROVEMENT_GUIDE.md`
- **Quality Standards:** `FAQ_QUALITY_STANDARDS.md`