The original title is "261 docs, 6 languages, one maintainer: frontmatter is the source of truth"

Short summary

A solo maintainer of 261 documentation guides across six languages explains how YAML frontmatter serves as the single source of truth for auto-generating all index pages. The system uses a PHP script to parse frontmatter, group guides into fixed categories, and flag missing entries as CI warnings. Translated guides intentionally omit frontmatter to prevent taxonomy drift, with the generator building flat alphabetical indexes from H1 headers instead.

• •YAML frontmatter drives all index generation for 261 guides across 6 languages
• •Missing frontmatter triggers visible CI warnings instead of silent gaps
• •Translations skip frontmatter to avoid taxonomy drift across locales

Generated with AI, which can make mistakes.