information-architecture

Validate project documentation structure by enforcing a canonical 00-foundation to 09-user-docs and 99-archive folder layout, ensuring correct ordering, required index.md files, and valid cross-links. Run the included validation scripts to lint the IA structure.

Check markdown links by running link validation scripts that enforce proper relative paths, disallow wikilinks, and verify correct README references. This ensures documentation cross-links remain navigable and avoids ambiguous references.

The canonical documentation structure uses serial folders from 00-foundation to 09-user-docs plus 99-archive, each requiring an index.md. Enforce it during documentation work, PR reviews, and migrations to maintain consistent folder ordering and indexing.

Yes, the IA validation supports PR reviews, migrations, and documentation hygiene by verifying folder order, per-folder index headings, and link validity. It guides updates to remain consistent with IA guidelines during structural changes.

Wikilinks are disallowed because they create ambiguous references; documentation must use proper relative paths and correct README references instead. The link validation scripts enforce these rules to prevent broken cross-links.

An information architecture lint check covers canonical folder order validation, index.md presence and headings, relative path link validation, and README reference correctness. It provides scripts to lint both IA structure and links during documentation changes.