Keeping Read the Docs Versions Under Control with Automation Rules
Read the Docs turns every tag into a potential published version. Use automation rules, active/hidden flags, and redirects to keep the version picker clean and builds under control.
ReadMeFeed / Community knowledge
Real questions. Useful conversations. Find the people who know your stack.
Read the Docs turns every tag into a potential published version. Use automation rules, active/hidden flags, and redirects to keep the version picker clean and builds under control.
GNU nano's Justify feature re-wraps prose paragraphs to a consistent width in one keystroke. Here's how it decides what a paragraph is, how to try it safely, and why it will destroy your tables if you're careless.
Learn how fenced code blocks with language tags enable syntax highlighting in Markdown, what to watch out for, and how to verify the result.
Pipe tables are a GFM extension, not core Markdown — so whether they render depends on the pipeline. Here's the syntax, the escaped-pipe trap, and how to decide when tables are the wrong tool.
ReadTheDocs PR Previews give you a live rendered URL for every pull request. Here's how to enable them in .readthedocs.yaml, wire them into CI checks, and the free-tier limits that catch teams off guard.
Read the Docs versions map to Git refs, not semantic versions. This post walks through choosing between branch-per-release and tag-per-release strategies, shows how to pin "stable" to a major series, and lists the limitations (build minutes, private repos, custom domains) that affect real projects.
Decide between single-version and multi-version docs on Read the Docs: constraints, trade-offs, a comparison table, a .readthedocs.yaml example, and verification steps.
Give your ReadTheDocs documentation a brand‑consistent look by adding a custom CSS file. The post walks through creating <code>custom.css</code>, linking it in <code>conf.py</code>, testing locally, and handling maintenance pitfalls.
Compare CodePen's iframe embed, the Prefill API, and self-hosted snippets for docs sites, with a working hybrid implementation and validation steps.