Read the Docsvs
MkDocs
MkDocs: One of the generators it hosts; self-hosting removes the build platform but also its versioning
Read the Docs
Documentation hosting with versioning built for open source
Overview
What Read the Docs does
Read the Docs builds and hosts documentation, most commonly from Sphinx or MkDocs sources. It watches a repository, rebuilds on every commit, and serves versioned documentation keyed to branches and tags — so a project’s v2 and v3 docs coexist with no manual work. It hosts open-source projects free, which is why an enormous share of Python documentation lives there. The versioning and pull request previews are the parts teams miss when they self-host.
What people use it for
- Open-source projects needing free hosted versioned documentation
- Teams wanting docs rebuilt automatically on every commit
- Reviewing documentation changes in a pull request before merge
Related searches
The honest half
Where it falls short
Concrete and checkable, so you can decide whether any of them matter to you. This is the half of a review a vendor will not write about Read the Docs.
- Build configuration is finicky, and build failures on dependency changes are a common frustration
- Default themes are recognisable and dated, so sites look alike unless customised
- Private documentation requires a paid business plan
- Build times on large projects are slow enough to interrupt a review cycle
Cross-shopped
What people choose instead of Read the Docs
Each pairing was judged by two reviewers asking whether a buyer would genuinely weigh the two against each other. The ones that failed were deleted rather than published.
- Read the DocsvsGitBook
GitBook: Hosted with a visual editor, for teams where non-engineers write the docs
Pricing
What Read the Docs costs
Taken from the vendor's own pricing page. Prices move, so check before you buy.
Free
Free
- Core functionality
- Public projects
Capabilities
Features
Build on commit
Documentation rebuilt automatically from the repository
Version by branch and tag
Multiple documentation versions served side by side
Pull request previews
Documentation changes reviewable before merge
Free for open source
No cost for public projects
Answered, with sources
Questions people ask
Each answer names the page it came from, so you can check it rather than take our word for it.
Is Read the Docs free?
Free for open-source public projects. Private documentation requires a paid business plan.
What does it build from?
Most commonly Sphinx or MkDocs sources kept in your repository.
How does versioning work?
It maps branches and tags to documentation versions, so several releases are served side by side without manual work.
Keep looking
Where to go from Read the Docs
- Read the Docs alternativesEvery product people weigh against it
- Read the Docs pricingPlans, floors and what the tiers exclude
- Read the Docs badgesWhich rules it meets, and the figure behind each
- All Documentation softwareThe full category
- Best Documentation softwareThe shortlist, and how it was cut
Best Documentation software for
Compare Read the Docs with
Other Documentation software
Great writing, simplified
Hosted documentation platform with Git synchronisation
Static site generator for project documentation in Markdown
API documentation and OpenAPI governance platform
Documentation generator built for large technical projects
Softwr does not host reviews and shows no star rating for Read the Docs, because a rating we did not collect is not ours to publish. What is here is the pricing and platform detail from the vendor’s own pages, limitations we could state concretely, and alternatives a reviewer confirmed people weigh against it. Tell us if any of it is wrong.
More on Read the Docs
Read the Docs alternatives
What people switch to, and what they give up
Read the Docs pricing
Every tier, and where the cost actually lands
Compare Read the Docs
Put it head to head with anything we hold
Read the Docs badge
Its rating, and an embed for your own site
Best Documentation software alternatives
API documentation and OpenAPI governance platform
Documentation generator built for large technical projects
Static site generator for project documentation in Markdown
Hosted documentation platform with Git synchronisation
Great writing, simplified