# Blog Post Review Workflow

**Last Updated:** 2026-01-11

Step-by-step workflow for reviewing blog posts, updating documentation, and creating improvement plans.

## Overview

This workflow guides the manual review process for blog posts, ensuring consistent quality and comprehensive documentation.

## Workflow Steps

### Step 1: Automated Analysis

Run all automated analysis scripts to generate initial data:

```bash
# Content analysis
php v2/scripts/blog/analyze-post-content.php --all

# SEO analysis
php v2/scripts/blog/analyze-post-seo.php --all

# Internal linking analysis
php v2/scripts/blog/analyze-post-links.php --all

# Data collection (run in batches to manage API credits)
php v2/scripts/blog/collect-post-keywords-sistrix.php --category=lexikon --limit=10
php v2/scripts/blog/collect-post-performance-ga4.php --category=lexikon --limit=10
php v2/scripts/blog/collect-post-performance-gsc.php --category=lexikon --limit=10
php v2/scripts/blog/map-post-related-resources.php --all
```

**Expected Output:**

- `content-analysis.json` - Content metrics and structure
- `seo-analysis.json` - SEO keywords and analysis
- `links-analysis.json` - Internal link inventory
- `keywords-sistrix.json` - SISTRIX keyword data
- `performance-ga4.json` - GA4 traffic metrics
- `performance-gsc.json` - GSC search metrics
- `related-resources.json` - Related tools/templates/downloads

### Step 2: Generate Initial Documentation

Generate initial documentation files from templates:

```bash
php v2/scripts/blog/generate-post-documentation.php --all
```

**Generated Files:**

- `POST_ANALYSIS.md` - Content analysis document
- `SEO_REPORT.md` - SEO performance report
- `INTERNAL_LINKS.md` - Internal linking analysis
- `IMPROVEMENT_PLAN.md` - Improvement recommendations (Ratgeber/Lexikon only)

### Step 3: Manual Content Review

For each post, complete manual review:

1. **Open Post Documentation Folder**

   - Navigate to `docs/content/blog/posts/{category}/{slug}/`
   - Review all generated files

2. **Review Content Analysis**

   - Read `POST_ANALYSIS.md`
   - Verify content depth assessment
   - Check FAQ quality
   - Identify content gaps

3. **Review SEO Report**

   - Read `SEO_REPORT.md`
   - Verify keyword targeting
   - Check meta tag optimization
   - Review performance metrics

4. **Review Internal Links**

   - Read `INTERNAL_LINKS.md`
   - Verify link relevance
   - Check related posts carousel
   - Identify missing link opportunities

5. **Use Review Checklist**
   - Open `docs/content/blog/POST_REVIEW_CHECKLIST.md`
   - Complete all checklist items
   - Document findings in notes section

### Step 4: Update Documentation

Update documentation files with manual review findings:

1. **Update POST_ANALYSIS.md**

   - Add manual notes
   - Refine content gaps
   - Update quality ratings
   - Add improvement priorities

2. **Update SEO_REPORT.md**

   - Add SEO recommendations
   - Refine keyword strategy
   - Update performance analysis
   - Add AEO/GEO opportunities

3. **Update INTERNAL_LINKS.md**
   - Add missing link opportunities
   - Refine link placement recommendations
   - Update carousel recommendations
   - Add cross-page type linking strategy

### Step 5: Create Improvement Plan (Ratgeber/Lexikon Only)

For Ratgeber and Lexikon posts:

1. **Review All Data**

   - Content analysis
   - SEO analysis
   - Link analysis
   - Performance data

2. **Generate Improvement Plan**

   ```bash
   php v2/scripts/blog/generate-improvement-plan.php --post={slug}
   ```

3. **Review and Refine**
   - Read generated `IMPROVEMENT_PLAN.md`
   - Add manual insights
   - Prioritize improvements
   - Assign effort estimates

### Step 6: Prioritize Improvements

1. **Categorize Improvements**

   - High priority (immediate impact)
   - Medium priority (next sprint)
   - Low priority (future)

2. **Estimate Effort**

   - Hours required
   - Resources needed
   - Dependencies

3. **Update Master Dashboard**
   - Add to `docs/content/blog/IMPROVEMENT_DASHBOARD.md`
   - Include priority and effort
   - Track status

## Review Schedule

### Initial Review (All Posts)

- **Lexikon Posts:** 54 posts
- **Ratgeber Posts:** 37 posts
- **Inside Ordio Posts:** 8 posts (documentation only)

### Ongoing Review

- Review posts quarterly
- Update documentation as content evolves
- Refresh performance data monthly
- Update improvement plans as priorities change

## Quality Standards

### Content Quality

- **Excellent:** 1,200+ words, comprehensive coverage, excellent structure
- **Good:** 800-1,199 words, good coverage, clear structure
- **Fair:** 500-799 words, basic coverage, needs improvement
- **Needs Improvement:** <500 words, shallow content, missing elements

### SEO Quality

- **Excellent:** 80+ SEO score, optimal meta tags, comprehensive keywords
- **Good:** 60-79 SEO score, good meta tags, adequate keywords
- **Fair:** 40-59 SEO score, needs optimization
- **Needs Improvement:** <40 SEO score, critical issues

### Link Quality

- **Excellent:** 80+ link score, diverse link types, high relevance
- **Good:** 60-79 link score, good distribution, relevant links
- **Fair:** 40-59 link score, needs more links
- **Needs Improvement:** <40 link score, critical gaps

## Tools and Resources

### Analysis Scripts

- `analyze-post-content.php` - Content analysis
- `analyze-post-seo.php` - SEO analysis
- `analyze-post-links.php` - Link analysis

### Data Collection Scripts

- `collect-post-keywords-sistrix.php` - SISTRIX keywords
- `collect-post-performance-ga4.php` - GA4 metrics
- `collect-post-performance-gsc.php` - GSC metrics
- `map-post-related-resources.php` - Related resources

### Documentation Scripts

- `generate-post-documentation.php` - Generate docs
- `generate-improvement-plan.php` - Generate improvement plans
- `validate-post-documentation.php` - Validate completeness

## Notes

- **SISTRIX Credits:** Monitor credit usage, batch process posts
- **API Rate Limits:** Respect rate limits for GA4 and GSC
- **Manual Review:** Critical for quality - automated analysis supports but doesn't replace manual review
- **Documentation Updates:** Keep documentation current as content evolves