Skip to content

Latest commit

 

History

History
252 lines (188 loc) · 6.34 KB

index.rst

File metadata and controls

252 lines (188 loc) · 6.34 KB

Read the Docs: Documentation Simplified

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 |:arrows_counterclockwise:|
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 :doc:`/webhooks`.
Multiple versions |:card_index_dividers:|
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 :doc:`/versions`.
Open Source and User Focused |:heartbeat:|
Our code is free and open source. :doc:`Our company </about>` is bootstrapped and 100% user focused. |org_brand| hosts documentation for over 100,000 large and small open source projects, in almost every human and computer language. |com_brand| supports hundreds of organizations with product and internal documentation.

You can find out more about our all the :doc:`/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.

.. toctree::
   :maxdepth: 2
   :hidden:
   :caption: First steps

   /intro/getting-started-with-sphinx
   /intro/getting-started-with-mkdocs

   /intro/import-guide
   /features
   /choosing-a-site


Getting started with Read the Docs

Learn more about configuring your automated documentation builds and some of the core features of Read the Docs.

.. toctree::
   :maxdepth: 1
   :hidden:
   :caption: Getting started

   /config-file/index
   /webhooks
   /custom_domains
   /versions
   /downloadable-documentation
   /hosting
   /server-side-search
   /analytics
   /pull-requests

   /connected-accounts

   /builds
   /badges

   /support
   /faq


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.

.. toctree::
 :maxdepth: 2
 :hidden:
 :caption: Step-by-step Guides

 /guides/tools
 /guides/platform
 /guides/commercial

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.

.. toctree::
   :maxdepth: 2
   :hidden:
   :glob:
   :caption: Advanced features

   subprojects
   single_version

   localization

   user-defined-redirects
   automatic-redirects

   automation-rules


   api/index


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.

.. toctree::
   :maxdepth: 1
   :hidden:
   :caption: About Read the Docs

   contribute
   development/index
   roadmap
   gsoc
   code-of-conduct

   security
   privacy-policy
   terms-of-service
   dmca/index
   abandoned-projects
   supported-tools
   changelog

   about
   team
   open-source-philosophy
   story

   advertising/index
   sponsors

   commercial/index