Read the Docs: documentation simplified๏ƒ

Mastodon

Read the Docs simplifies software documentation by building, versioning, and hosting of your docs, automatically. Treating documentation like code keeps your team in the same tools, and your documentation up to date.

๐Ÿ”„ Up to date documentation

Whenever you push code to Git, Read the Docs will automatically build your docs so your code and documentation are always up-to-date. Get started with our tutorial.

๐Ÿ—‚๏ธ Documentation for every version

Read the Docs can host multiple versions of your docs. Keep your 1.0 and 2.0 documentation online, pulled directly from Git. Start hosting all your versions.

๐Ÿ’“ Open source and user focused

Our company is bootstrapped and 100% user-focused, so our product gets better for our users instead of our investors. Read the Docs Community hosts documentation for over 100,000 large and small open source projects. Read the Docs for Business supports hundreds of organizations with product and internal documentation. Learn more about our two platforms.

First time here?๏ƒ

We have a few places for you to get started:

๐Ÿš€ Read the Docs tutorial

Take the first practical steps with Read the Docs.

๐Ÿš€ Example projects

Start your journey with an example project to hit the ground running.

๐Ÿš€ All tutorials

Using documentation tools like Sphinx or MkDocs for the first time or importing an existing project? We have the tutorials to get you started!

Explanation๏ƒ

Get a high-level overview of our platform:

๐Ÿ’ก Continuous Documentation

Discover the advantages of having your documentation continuously deployed.

๐Ÿ’ก Choosing between our two platforms

Learn about the differences between Read the Docs Community and Read the Docs for Business.

๐Ÿ’ก Deep dive into Read the Docs

Get familiar with some of the more advanced topics of building and deploying documentation with Read the Docs.

๐Ÿ’ก All explanation articles

Browse all our explanation articles.

How-to guides๏ƒ

Need to get something specific done? These guides provide step-by-step instructions in key areas to get you up to speed faster:

๐Ÿช„ How to configure pull request builds

Setup pull request builds and enjoy previews of each commit.

๐Ÿช„ How to use traffic analytics

Learn more about how users are interacting with your documentation.

๐Ÿช„ How to use cross-references with Sphinx

Learn how to use cross-references in a Sphinx project.

๐Ÿช„ All how-to guides

Browser the entire catalog for many more how-to guides.

Reference๏ƒ

Need to know how something works? Here are a few of the most important reference docs:

๐Ÿ“š Feature reference

Overview of all the main features of Read the Docs.

๐Ÿ“š Configuration file v2 (.readthedocs.yaml)

Information for our configuration file: .readthedocs.yaml.

๐Ÿ“š Build process overview

Overview of how documentation builds happen.

๐Ÿ“š Build process customization

Information on how to add your own build logic or replace default build steps.

๐Ÿ“š Public API

Automate your documentation with our API and save yourself some work.