Read the Docs: Documentation Simplified¶
TEST ReadTheDocs Site ( Jeonghun )¶
Read the Docs simplifies software documentation by building, versioning, and hosting of your docs, automatically. Think of it as Continuous Documentation.
- Never out of sync 🔄
Whenever you push code to your favorite version control system, whether that is Git, Mercurial, Bazaar, or Subversion, Read the Docs will automatically build your docs so your code and documentation are always up-to-date. Read more about Incoming Webhooks and Automation.
- Multiple versions 🗂️
Read the Docs can host and build multiple versions of your docs so having a 1.0 version of your docs and a 2.0 version of your docs is as easy as having a separate branch or tag in your version control system. Read more about Versioned Documentation.
- Open Source and User Focused 💓
Our code is free and open source. Our company is bootstrapped and 100% user focused. Read the Docs Community hosts documentation for over 100,000 large and small open source projects, in almost every human and computer language. Read the Docs for Business supports hundreds of organizations with product and internal documentation.
You can find out more about our all the Read the Docs features in these pages.
First steps¶
Are you new to software documentation or are you looking to use your existing docs with Read the Docs? Learn about documentation authoring tools such as Sphinx and MkDocs to help you create fantastic documentation for your project.
Getting started: With Sphinx | With MkDocs | Feature Overview | Choosing Between Our Two Sites
Importing your existing documentation: Import guide
Getting started with Read the Docs¶
Learn more about configuring your automated documentation builds and some of the core features of Read the Docs.
Overview of core features: Incoming webhooks | Custom Domains and White Labeling | Versioned Documentation | Downloadable Documentation | Documentation Hosting Features | Server Side Search | Analytics Preview Documentation from Pull Requests
Connecting with GitHub, BitBucket, or GitLab: Connecting your VCS account | VCS webhooks
Read the Docs build process: Configuration reference | Build process | Badges |
Troubleshooting: Site Support | Frequently asked questions
Step-by-step Guides¶
These guides will help walk you through specific use cases related to Read the Docs itself, documentation tools like Sphinx and MkDocs and how to write successful documentation.
Advanced features of Read the Docs¶
Read the Docs offers many advanced features and options. Learn more about these integrations and how you can get the most out of your documentation and Read the Docs.
Advanced project configuration: Subprojects | Single version docs
Multi-language documentation: Translations and localization
Redirects: User defined redirects | Automatic redirects
Versions Automation rules
Topic specific guides: How-to guides
Extending Read the Docs: REST API
The Read the Docs project and organization¶
Learn about Read the Docs, the project and the company, and find out how you can get involved and contribute to the development and success of Read the Docs and the larger software documentation ecosystem.
Getting involved with Read the Docs: Contributing | Development installation | Roadmap | Code of conduct
Policies & Process: Security | DMCA takedown policy | Policy for abandoned projects | Release notes & changelog
The people and philosophy behind Read the Docs: About Us | Team | Open source philosophy | Our story
Financial and material support: Advertising | Sponsors
Read the Docs for Business: Support and additional features
Legal documents: Terms of service | Privacy policy | Data processing agreement