# Blog Documentation Index

**Last Updated:** 2026-02-08

Single entry point for blog documentation: data layout, key reports, main scripts, and pointers to runbooks and guides.

## Data layout

- **Per-post data:** `docs/content/blog/posts/{category}/{slug}/data/`
  - `performance-gsc.json`, `performance-ga4.json`, `keywords-sistrix.json`, `serp-features.json`, `faq-research.json`, `prioritization-data.json`
  - Per-post reports: `data/reports/` (traffic-analysis-report.md, seo-performance-report.md, etc.)
- **Post list source:** `v2/data/blog/posts/` (one JSON per post; categories: lexikon, ratgeber, inside-ordio)
- **Shared/domain data:** `docs/content/blog/seo-reports/`, `docs/content/blog/domain-level-data/`

## Key reports

| Report | Description | Regenerate |
|--------|-------------|------------|
| [DATA_FRESHNESS_REPORT.md](DATA_FRESHNESS_REPORT.md) | Freshness of post data files (7-day threshold) | `php v2/scripts/blog/generate-data-freshness-report.php` |
| [COLLECTION_HEALTH_DASHBOARD.md](COLLECTION_HEALTH_DASHBOARD.md) | GSC/GA4 error logs and API health | `php v2/scripts/blog/monitor-collection-health.php` |
| [PRIORITY_DASHBOARD.md](PRIORITY_DASHBOARD.md) | Priority scores, quick wins, opportunities | `php v2/scripts/blog/generate-priority-dashboard.php` |
| [CONTENT_BACKLOG.md](CONTENT_BACKLOG.md) | **Single place for "what to do next":** optimize existing (top N by priority) + create new (domain opportunities, content ideas) | `php v2/scripts/blog/generate-content-backlog.php` |
| [TRAFFIC_SEO_SNAPSHOT_*.md](TRAFFIC_SEO_SNAPSHOT_2026-02-08.md) | Top posts by clicks, impressions, page views | `php v2/scripts/blog/generate-traffic-seo-snapshot.php` |
| [FRESHNESS_VALIDATION_SUMMARY.md](FRESHNESS_VALIDATION_SUMMARY.md) | Summary of freshness and validation script runs | Manual / audit |
| [AUDIT_TODO_2026-02.md](AUDIT_TODO_2026-02.md) | Audit checklist (no step skipped) | Use during audits |

## Main scripts

- **Freshness:** `php v2/scripts/blog/check-data-freshness.php` (--all, --tier=1, --max-age=7, --auto-refresh)
- **Validation:** `php v2/scripts/blog/validate-data-collection.php --all --stale-days=30`, `php v2/scripts/blog/validate-api-data-quality.php --all`
- **Weekly pipeline:** `php v2/scripts/blog/weekly-priority-refresh.php` (GA4 → GSC → priority calculation → priority dashboard)
- **Dashboard/reports:** `generate-priority-dashboard.php`, `generate-data-freshness-report.php`, `generate-traffic-seo-snapshot.php`, `generate-automated-reports.php` (per post)

## Core documentation

- [MONITORING_RUNBOOK.md](MONITORING_RUNBOOK.md) – Automated monitoring, cron setup, troubleshooting
- [SEO_DATA_MANAGEMENT.md](SEO_DATA_MANAGEMENT.md) – Data freshness, SISTRIX/GSC/GA4 usage, shared keywords
- [PERFORMANCE_ANALYSIS.md](PERFORMANCE_ANALYSIS.md) – How GA4/GSC data is collected and used for analysis
- [CONSOLIDATED_NEXT_STEPS.md](CONSOLIDATED_NEXT_STEPS.md) – Single next-steps entry point for the blog
- [FINAL_STATUS.md](FINAL_STATUS.md) – Current blog system status
- [BLOG_SCRIPTS_USAGE_GUIDE.md](BLOG_SCRIPTS_USAGE_GUIDE.md) – Script usage and options

## Guides and reference

- `docs/content/blog/guides/` – Data collection, SEO, content extraction, troubleshooting
- `docs/content/blog/reference/` – Component API, demo CTA pattern
- `.cursor/rules/blog-*.mdc` – Cursor rules for blog (see [docs/ai/RULE_TO_DOC_MAPPING.md](../../ai/RULE_TO_DOC_MAPPING.md))