Skip to content

docs: make asciinema README markdown so sphinx ignores it#9938

Merged
ThomasWaldmann merged 1 commit into
borgbackup:masterfrom
ThomasWaldmann:fix-asciinema-readme-toctree-master
Jul 22, 2026
Merged

docs: make asciinema README markdown so sphinx ignores it#9938
ThomasWaldmann merged 1 commit into
borgbackup:masterfrom
ThomasWaldmann:fix-asciinema-readme-toctree-master

Conversation

@ThomasWaldmann

Copy link
Copy Markdown
Member

docs/misc/asciinema/README.rst was picked up by sphinx but not part of any toctree, producing a CI warning:

docs/misc/asciinema/README.rst: WARNING: document isn't included in any toctree [toc.not_included]

(collateral damage from the asciinema updates in #9925.)

This README is developer notes, not part of the built documentation. Renaming it to README.md fixes the warning: conf.py sets source_suffix = ".rst", so sphinx ignores markdown files entirely. Nothing referenced it in a toctree, so no other changes are needed.

🤖 Generated with Claude Code

docs/misc/asciinema/README.rst was picked up by sphinx but not part of any
toctree, causing a "document isn't included in any toctree" warning in CI.
As this README is developer notes, not part of the built docs, rename it to
README.md: conf.py has source_suffix = ".rst", so sphinx ignores markdown.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WRRe8BEFk4sV2GHVxDRo5A
@ThomasWaldmann
ThomasWaldmann merged commit a799ba6 into borgbackup:master Jul 22, 2026
@ThomasWaldmann
ThomasWaldmann deleted the fix-asciinema-readme-toctree-master branch July 22, 2026 23:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant