Last development

Task

Align Pet portal navigation titles with compact route labels.

Changed areas

All Pet documentation title fields, project progress, and this handover.

What changed

All 55 Pet Markdown documents now use compact lower-case route labels in frontmatter. Normal pages use their file stem, directory landing pages use the directory name, and the root landing page uses pet.

Architecture decision labels retain their number and no more than two short topic terms. Examples include 01-fixed-capacity, 08-dependency-overrides, and 11-greet-presentation. Full authored level-one headings and document bodies remain unchanged.

The QSS fallback remains available for future pages without an authored title. It derives a lower-case title from the first authored level-one heading and shortens it at a word boundary when required. Authored frontmatter remains authoritative.

Tests and checks

A pre-change archive is available at /tmp/pet-docs-before-route-titles-20260728.tar.

The migration changed only frontmatter title lines. Its second dry-run reported zero changes. Validation confirmed all 55 metadata blocks, every expected route label, unique ADR labels, and byte-for-byte equality outside each title line.

The full Pet product verification gate was not run because no product code, build file, test, or platform contract changed.

Component files updated

no component knowledge files required updates

Known limitations

The route label is intentionally shorter than the page heading and is not a replacement for descriptive document content.

Suggested commits

No commit is suggested. Every changed Pet path is under the ignored docs/ tree and must remain outside Git staging.

Suggested next step

Continue with the selected Quartz presentation customisation slice.