mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2026-11-09 04:06:42 +00:00
Sphinx prefers nothing: dir/index and dir/README are two independent documents. The preference lives wherever something maps a folder onto a page, and this repository had two such places disagreeing. local.file_headings has always hidden README.md from a directory carrying an index.rst, while yesterday's resolver saw README only, so a link led to the page the sidebar hides. Both now try index.rst, index.md, README.md, README.rst in that order. The extension is renamed accordingly, and the tuple lives once in the lint package rather than a third time. That also repairs two links this branch degraded: roles/ holds an index.rst and no README, so a README-only rule reported every reference to it as broken and they were turned into code spans. Three links stay code spans on purpose. Their text names something the target is not - a suite, a file - so resolving them would restore a misleading reference rather than a working one. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Contribution documentation 🤝
This directory contains contributor-facing repository rules and workflows. Its scope is how humans and agents set up the environment, write documentation, communicate, define requirements, and contribute safely through the project lifecycle.