mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2026-11-09 04:06:42 +00:00
kevinveenbirkenbachandClaude Opus 5
d8caa45420
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>
Design 🎨
This directory contains contributor guidance for code design and implementation. Its scope is architecture, service wiring, coding principles, exceptions, and the boundaries that shape maintainable changes.