# Blog Post Documentation Structure

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

Complete documentation system for individual blog posts, providing deep analysis, SEO performance tracking, and improvement plans.

## Structure

Each blog post has its own documentation folder located at:

```
docs/content/blog/posts/{category}/{slug}/
```

### Required Files

1. **POST_ANALYSIS.md** - Main content analysis document

   - Post metadata
   - Content quality assessment
   - Topic coverage analysis
   - Content gaps identification
   - FAQ analysis

2. **SEO_REPORT.md** - SEO performance and keyword analysis

   - Target keywords (primary, secondary)
   - LSI keywords
   - Performance metrics (GSC, GA4)
   - Meta tags review
   - SEO score

3. **INTERNAL_LINKS.md** - Internal linking analysis

   - Current links inventory
   - Related posts carousel review
   - Missing link opportunities
   - Link quality assessment

4. **IMPROVEMENT_PLAN.md** - Actionable improvement recommendations
   - Content improvements
   - SEO optimizations
   - Internal linking improvements
   - Supporting elements
   - Priority ranking
   - **Note:** Only for Ratgeber and Lexikon posts

### Data Files

Each post folder contains a `data/` subdirectory with:

- `keywords-sistrix.json` - SISTRIX keyword data
- `performance-ga4.json` - Google Analytics 4 metrics
- `performance-gsc.json` - Google Search Console data
- `related-resources.json` - Related tools, templates, downloads

## Categories

- **lexikon/** - 54 posts (improvement plans included)
- **ratgeber/** - 37 posts (improvement plans included)
- **inside-ordio/** - 8 posts (documentation only, no improvement plans)

## Workflow

1. Automated scripts generate initial documentation and data files
2. Manual review updates documentation with human insights
3. Improvement plans created for Ratgeber/Lexikon posts
4. Regular updates as content and performance evolve

## Related Documentation

- [Review Workflow](../REVIEW_WORKFLOW.md)
- [Post Review Checklist](../POST_REVIEW_CHECKLIST.md)
- [Improvement Dashboard](../IMPROVEMENT_DASHBOARD.md)