# Batch Review Guide

**Last Updated:** 2026-01-11  
**Purpose:** Guide for efficient batch processing of blog post manual reviews

## Overview

Batch review allows processing multiple posts efficiently while maintaining quality. This guide outlines the batch review process, best practices, and quality standards.

## Batch Size Recommendations

### Small Batches (3-5 posts)

- **When to use:** Starting out, learning process, high-priority posts
- **Advantages:** Focus, quality, easier validation
- **Time per batch:** 2-3 hours

### Medium Batches (5-10 posts)

- **When to use:** Established process, medium-priority posts
- **Advantages:** Good balance of speed and quality
- **Time per batch:** 3-5 hours

### Large Batches (10-20 posts)

- **When to use:** Low-priority posts, final push
- **Advantages:** Maximum throughput
- **Time per batch:** 5-8 hours

## Batch Selection Strategy

### Priority-Based Selection

1. **High Priority (Score ≥ 60):** Process first, small batches (3-5 posts)
2. **Medium Priority (Score 50-59):** Process second, medium batches (5-10 posts)
3. **Low Priority (Score < 50):** Process last, large batches (10-20 posts)

### Category-Based Selection

- Process by category for consistency (all Ratgeber, then all Lexikon, etc.)
- Maintains context and allows pattern recognition
- Easier to identify category-specific improvements

### Traffic-Based Selection

- Process high-traffic posts first (more impact)
- Use GSC data to identify high-impression posts
- Focus on posts with ranking opportunities (position 5-15)

## Batch Review Process

### Step 1: Batch Preparation

1. **Select Posts:** Choose 3-10 posts based on priority/category
2. **Verify Data:** Ensure all data files exist for selected posts
3. **Run Auto-Fill:** `php v2/scripts/blog/auto-fill-placeholders.php --all`
4. **Validate Automated:** `php v2/scripts/blog/validate-placeholder-completion.php --all`

### Step 2: Batch Processing

For each post in batch:

1. **Review POST_ANALYSIS.md:** Complete manual notes, observations, priorities
2. **Review SEO_REPORT.md:** Complete SEO notes, observations, priorities
3. **Review INTERNAL_LINKS.md:** Complete link notes, observations, priorities
4. **Review IMPROVEMENT_PLAN.md:** Complete improvement notes, priorities

**Time per post:** 30-45 minutes

### Step 3: Batch Validation

1. **Validate Placeholders:** `php v2/scripts/blog/validate-placeholder-completion.php --post={slug} --category={category}` for each post
2. **Validate Quality:** `php v2/scripts/blog/validate-documentation-quality.php --post={slug} --category={category}` for each post
3. **Update Progress:** `php v2/scripts/blog/generate-review-progress-tracker.php`

### Step 4: Batch Documentation

1. **Create Batch Summary:** Document completed posts, common patterns, improvements
2. **Update Progress Tracker:** Mark posts as completed
3. **Document Learnings:** Note patterns, improvements, issues

## Quality Standards

### Minimum Requirements

- All manual placeholders completed
- All automated placeholders filled
- Quality score documented
- Improvement priorities identified

### Quality Targets

- **Manual Notes:** Comprehensive, specific, actionable
- **Observations:** 2+ per section, data-driven
- **Priorities:** Properly prioritized (High/Medium/Low)
- **Consistency:** Notes align across all 4 files

## Efficiency Tips

### Pattern Recognition

- **Identify Common Patterns:** Similar posts have similar improvements
- **Reuse Insights:** Adapt insights from similar posts
- **Template Approach:** Use previous posts as templates

### Focus Areas

- **High-Impact First:** Focus on improvements with most impact
- **Quick Wins:** Identify easy improvements (meta optimization, FAQ addition)
- **Critical Gaps:** Address critical gaps first (missing FAQs, low link count)

### Time Management

- **Set Time Limits:** 30-45 minutes per post
- **Batch Similar Posts:** Process similar posts together
- **Skip Low-Value Tasks:** Focus on high-value improvements

## Common Patterns

### Ratgeber Posts

- **Common Issues:** Missing FAQs, low word count, weak internal linking
- **Common Improvements:** Add FAQs, expand content, add tool links
- **Typical Priorities:** FAQ section, content expansion, internal linking

### Lexikon Posts

- **Common Issues:** Missing FAQs, weak internal linking, no tool links
- **Common Improvements:** Add FAQs, add tool links, strengthen definitions
- **Typical Priorities:** FAQ section, tool links, definition optimization

### Inside Ordio Posts

- **Common Issues:** Low word count, weak internal linking
- **Common Improvements:** Expand content, add product links
- **Typical Priorities:** Content expansion, product links

## Validation Checklist

### Per Post

- [ ] All placeholders completed
- [ ] Quality score documented
- [ ] Improvement priorities identified
- [ ] Validation passes

### Per Batch

- [ ] All posts validated
- [ ] Batch summary created
- [ ] Progress tracker updated
- [ ] Common patterns documented

## Troubleshooting

### Common Issues

1. **Missing Data:** Check data files exist, regenerate if needed
2. **Placeholder Errors:** Run auto-fill script, check for typos
3. **Validation Failures:** Review errors, fix issues, revalidate

### Quality Issues

1. **Incomplete Notes:** Ensure all sections completed
2. **Generic Observations:** Make observations specific and data-driven
3. **Missing Priorities:** Ensure priorities are properly prioritized

## Batch Review Template

### Batch Summary Format

```markdown
# Manual Review Batch X Complete

**Last Updated:** YYYY-MM-DD
**Status:** ✅ Batch X Complete (N posts)

## Batch Summary

- Posts Completed: N/99 (X%)
- Manual placeholders completed: N posts
- All automated placeholders filled: 294/294 (100%)

## Completed Posts Details

[Post details with key improvements]

## Common Patterns Identified

[Common patterns, strengths, weaknesses]

## Next Steps

[Next batch, process improvements]

## Metrics

[Performance metrics, time per post]
```

## Notes

- Process batches systematically
- Maintain quality standards
- Document learnings
- Update progress regularly
- Adjust batch size based on experience
