# Tier 1 FAQ Manual Review Guide

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

Guide for manually reviewing Tier 1 FAQs after automated generation and quality enhancement.

## Overview

All 20 Tier 1 posts have been processed with the improved data-driven FAQ generation system. This guide helps prioritize and conduct manual review.

## Review Priority

### High Priority (Scores < 35/100)

These posts need immediate attention:

1. **`lexikon/24-stunden-schicht`** - Score: 33.6/100

   - Issues: 19 (mostly too short answers, missing primary keyword)
   - Action: Regenerate with better keyword integration

2. **`lexikon/industrieminuten`** - Score: 34.3/100

   - Issues: 32 (multiple quality issues)
   - Action: Regenerate with improved answers

3. **`ratgeber/dienstplan-erstellen`** - Score: 34.9/100
   - Issues: 14 (quality issues)
   - Action: Review and improve answers

### Medium Priority (Scores 35-40/100)

These posts need review but are in better shape:

4. `lexikon/reinigungsplan` - 35.3/100
5. `ratgeber/2025-gastronomie-mindestlohn` - 35.7/100
6. `lexikon/feiertagszuschlag` - 36.3/100
7. `lexikon/lohnersatzleistungen` - 36.8/100
8. `ratgeber/dienstplan-gesetz` - 36.9/100
9. `ratgeber/zeiterfassung-gastronomie-pflicht` - 37.3/100
10. `ratgeber/urlaubsantrag-stellen` - 37.4/100

### Lower Priority (Scores > 40/100)

These posts are in good shape but still need review:

- All other Tier 1 posts with scores > 40/100

## Common Issues Found

### 1. Answer Length Issues

**Problem:** Answers too short (< 40 words) or too long (> 80 words)

**Examples:**

- "24-stunden-schicht": Multiple answers with 18-38 words
- "industrieminuten": Several answers below 40 words

**Action:**

- Regenerate answers for posts with many short answers
- Use `generate-faq-answers-optimized.php --use-ai` for better quality

### 2. Missing Primary Keyword

**Problem:** Primary keyword not found in answers

**Examples:**

- Most FAQs in "24-stunden-schicht" missing primary keyword
- Many FAQs missing keyword integration

**Action:**

- Check if primary keyword is correctly identified
- Regenerate with better keyword integration
- Verify research data includes correct primary keyword

### 3. Template Language

**Problem:** Answers contain template phrases like "Informiere dich über"

**Examples:**

- Multiple FAQs contain "Informiere dich über"
- Generic phrases that sound AI-generated

**Action:**

- Review and rewrite answers with natural language
- Remove template phrases
- Use more specific, contextual language

### 4. HTML Formatting Issues

**Status:** ✅ Fixed (96 issues fixed automatically)

Most HTML formatting issues have been fixed, but verify:

- No question tags in answers
- No "Handlungsempfehlung:" labels
- Proper paragraph wrapping

## Review Process

### Step 1: Load FAQ Files

For each post, review:

- `docs/content/blog/posts/{category}/{slug}/data/faq-questions.json`
- `docs/content/blog/posts/{category}/{slug}/data/faq-answers-optimized.json`

### Step 2: Check Quality Report

Review the detailed quality report:

- `docs/content/blog/FAQ_QUALITY_REPORT.md`

Focus on:

- Overall score
- Specific issues per FAQ
- Keyword integration scores
- Answer quality scores

### Step 3: Review Each FAQ

For each FAQ, check:

1. **Question Quality:**

   - Is it a real user question?
   - Does it match search intent?
   - Is it clear and specific?

2. **Answer Quality:**

   - Length: 40-80 words (target: 60)
   - Natural language (no template phrases)
   - Primary keyword integrated naturally
   - LSI keywords integrated naturally
   - Du tone (informal "du")
   - Actionable information when relevant

3. **SEO/AEO/GEO:**
   - Keyword integration
   - Natural language
   - Structured for AI search engines
   - Sufficient context for generative AI

### Step 4: Edit FAQs

Edit FAQs directly in the JSON files:

```json
{
  "question": "Improved question?",
  "answer": "<p>Improved answer with 40-80 words, natural language, keyword integration...</p>"
}
```

### Step 5: Regenerate if Needed

For posts with many issues, regenerate:

```bash
# Regenerate specific post
php v2/scripts/blog/regenerate-tier1-faqs.php --post=slug --category=category

# Or regenerate questions/answers separately
php v2/scripts/blog/generate-faq-questions.php --post=slug --category=category
php v2/scripts/blog/generate-faq-answers-optimized.php --post=slug --category=category --use-ai
```

### Step 6: Re-enhance Quality

After editing, re-run quality enhancement:

```bash
php v2/scripts/blog/enhance-faq-quality.php --post=slug --category=category --fix-html --remove-duplicates
```

## Review Checklist

Use `FAQ_MANUAL_REVIEW_CHECKLIST.md` for detailed checklist.

**Quick Checklist:**

- [ ] All FAQs have 10-15 questions
- [ ] All answers are 40-80 words
- [ ] Primary keyword integrated naturally
- [ ] No template language
- [ ] Du tone consistent
- [ ] Natural, conversational language
- [ ] No HTML formatting issues
- [ ] No duplicate questions
- [ ] Internal links placed naturally (2-3 total)

## Post-Review Actions

### 1. Update Review Progress

```bash
php v2/scripts/blog/track-faq-review-progress.php --update
```

### 2. Add Approved FAQs to Posts

```bash
php v2/scripts/blog/add-faqs-to-post.php --post=slug --category=category
```

### 3. Validate Schema

```bash
php v2/scripts/blog/validate-faq-schema.php --post=slug --category=category
```

### 4. Test Display

- Check FAQs appear correctly on blog post page
- Verify schema markup renders correctly
- Test mobile responsiveness
- Test accessibility (keyboard navigation)

## Regeneration Commands

### Regenerate Low-Scoring Posts

For posts with scores < 35/100:

```bash
# Full regeneration
php v2/scripts/blog/regenerate-tier1-faqs.php --post=24-stunden-schicht --category=lexikon

# Or step-by-step
php v2/scripts/blog/collect-faq-research-data.php --post=24-stunden-schicht --category=lexikon --skip-sistrix
php v2/scripts/blog/generate-faq-questions.php --post=24-stunden-schicht --category=lexikon
php v2/scripts/blog/generate-faq-answers-optimized.php --post=24-stunden-schicht --category=lexikon --use-ai
php v2/scripts/blog/enhance-faq-quality.php --post=24-stunden-schicht --category=lexikon --fix-html --remove-duplicates
```

## Expected Outcomes

After manual review:

1. **All FAQs meet quality standards:**

   - 40-80 words per answer
   - Natural language
   - Keyword integration
   - No template phrases

2. **All FAQs approved:**

   - Ready for publication
   - Schema validated
   - Display tested

3. **Progress Updated:**
   - Review status tracked
   - Approved status tracked
   - Published status tracked

## Resources

- **Quality Report:** `docs/content/blog/FAQ_QUALITY_REPORT.md`
- **Review Checklist:** `docs/content/blog/FAQ_MANUAL_REVIEW_CHECKLIST.md`
- **Workflow Guide:** `docs/content/blog/FAQ_CREATION_WORKFLOW_2026.md`
- **Progress Tracking:** `docs/content/blog/FAQ_REBUILD_PROGRESS.md`

## Next Steps After Review

1. **Tier 2 Processing:** After Tier 1 review complete, proceed with Tier 2
2. **Tier 3 Processing:** After Tier 2 complete, proceed with Tier 3
3. **Ongoing Maintenance:** Weekly data freshness checks, monthly quality reviews