# Blog Manual Review Quick Reference Guide

**Last Updated:** 2026-01-11  
**Purpose:** Quick reference for common manual review tasks

## Quick Start

### 1. Check Current Status

```bash
cat docs/content/blog/REVIEW_PROGRESS_TRACKER.md
cat docs/content/blog/REVIEW_PRIORITY_LIST.md
```

### 2. Select a Post to Review

- Check priority list for high-priority posts
- Focus on posts with score ≥ 60 first
- Process 5-10 posts per batch

### 3. Review Post Documentation

Navigate to: `docs/content/blog/posts/{category}/{slug}/`

**Files to review:**

1. `MANUAL_REVIEW_CHECKLIST.md` - Personalized checklist
2. `POST_ANALYSIS.md` - Content analysis
3. `SEO_REPORT.md` - SEO analysis
4. `INTERNAL_LINKS.md` - Link analysis
5. `IMPROVEMENT_PLAN.md` - Improvement plan (Ratgeber/Lexikon only)

## Common Tasks

### Auto-Fill Placeholders

```bash
# Single post
php v2/scripts/blog/auto-fill-placeholders.php --post={slug} --category={category}

# All posts (dry run first)
php v2/scripts/blog/auto-fill-placeholders.php --all --dry-run
php v2/scripts/blog/auto-fill-placeholders.php --all
```

### Validate Completion

```bash
# Quality validation
php v2/scripts/blog/validate-documentation-quality.php --post={slug} --category={category}

# Placeholder completion
php v2/scripts/blog/validate-placeholder-completion.php --post={slug} --category={category}
```

### Regenerate Documentation

```bash
# Safe regeneration (preserves manual edits)
php v2/scripts/blog/safe-regenerate-documentation.php --post={slug} --category={category} --backup

# Regenerate all
php v2/scripts/blog/safe-regenerate-documentation.php --all --backup
```

### Update Progress Tracker

```bash
php v2/scripts/blog/generate-review-progress-tracker.php
```

## Placeholder Completion

### Automated Placeholders (Auto-Fillable)

- `{SEO_SCORE}` → From `data/seo-analysis.json`
- `{REPORT_TIMESTAMP}` → From file modification time

**Auto-fill:**

```bash
php v2/scripts/blog/auto-fill-placeholders.php --all
```

### Manual Placeholders (Require Human Input)

- `{MANUAL_SEO_NOTES}` → Add SEO insights
- `{MANUAL_LINK_NOTES}` → Add linking strategy
- `{MANUAL_IMPROVEMENT_NOTES}` → Add improvement priorities
- `{MANUAL_OBSERVATION_1}` → Add content observations
- `{MANUAL_STRENGTH_1}` → Add content strengths
- `{MANUAL_WEAKNESS_1}` → Add content weaknesses
- `{MANUAL_HIGH_PRIORITY_1}` → Add high-priority improvements

**Complete manually in:** `<!-- BEGIN MANUAL -->` sections

## Completion Checklist

A post is complete when:

- [ ] All automated placeholders filled
- [ ] All manual placeholders contain actual content
- [ ] Manual sections have insights (not template text)
- [ ] All 4 documentation files present (3 for Inside Ordio)
- [ ] Quality validation passes
- [ ] Placeholder validation passes

## File Locations

### Documentation Files

```
docs/content/blog/posts/{category}/{slug}/
├── POST_ANALYSIS.md
├── SEO_REPORT.md
├── INTERNAL_LINKS.md
├── IMPROVEMENT_PLAN.md (Ratgeber/Lexikon only)
├── MANUAL_REVIEW_CHECKLIST.md
└── data/
    ├── seo-analysis.json
    ├── content-analysis.json
    ├── links-analysis.json
    └── related-resources.json
```

### Scripts

```
v2/scripts/blog/
├── auto-fill-placeholders.php
├── validate-placeholder-completion.php
├── safe-regenerate-documentation.php
├── generate-review-progress-tracker.php
└── validate-documentation-quality.php
```

## Priority Levels

### High Priority (Score ≥ 60)

- Complete first
- Comprehensive review
- All placeholders filled
- Detailed manual insights

### Medium Priority (Score 40-59)

- Complete second
- Essential placeholders filled
- Basic manual insights
- Focus on quick wins

### Low Priority (Score < 40)

- Complete last
- Essential placeholders only
- Basic insights
- Minimal manual review

## Common Placeholders

### POST_ANALYSIS.md

- `{SEO_SCORE}` → Auto-fillable
- `{REPORT_TIMESTAMP}` → Auto-fillable
- `{MANUAL_OBSERVATION_1}` → Manual
- `{MANUAL_STRENGTH_1}` → Manual
- `{MANUAL_WEAKNESS_1}` → Manual
- `{MANUAL_HIGH_PRIORITY_1}` → Manual

### SEO_REPORT.md

- `{MANUAL_SEO_NOTES}` → Manual
- `{MANUAL_SEO_OBSERVATION_1}` → Manual
- `{MANUAL_SEO_HIGH_PRIORITY_1}` → Manual

### INTERNAL_LINKS.md

- `{MANUAL_LINK_NOTES}` → Manual
- `{MANUAL_LINK_OPPORTUNITY_1}` → Manual

### IMPROVEMENT_PLAN.md

- `{SEO_SCORE}` → Auto-fillable
- `{MANUAL_IMPROVEMENT_NOTES}` → Manual

## Workflow Summary

1. **Select Post** → Check priority list
2. **Auto-Fill** → Run auto-fill script
3. **Review** → Complete manual placeholders
4. **Validate** → Run validation scripts
5. **Update Tracker** → Regenerate progress tracker
6. **Next Post** → Repeat

## Tips

- **Batch Processing:** Process 5-10 posts per batch
- **Test First:** Always test scripts on one post first
- **Backup:** Use `--backup` flag for regeneration
- **Validate:** Run validation after each batch
- **Document:** Note any issues or learnings

## Getting Help

- **Troubleshooting:** See `TROUBLESHOOTING_GUIDE.md`
- **Workflow:** See `MANUAL_REVIEW_WORKFLOW.md`
- **Training:** See `MANUAL_REVIEWER_TRAINING_GUIDE.md`
- **Placeholders:** See `PLACEHOLDER_COMPLETION_STRATEGY.md`