ReadTheDocs

ReadTheDocs is a cloud service for publishing and hosting documentation using the Sphinx documentation generator (see Sphinx). The documentation your are reading is hosted on readthedocs.

Features

ReadTheDocs provide the following services: * hosting of documentation of open source projects * continuous Sphinx generation (connected to GitHub) * management of documentation versioning within the browser * support for downloading documentation in html, pdf, and e-pub formats * searchable documentation

Installation

No installation is required as this service is on the cloud. However you must create an ReadTheDocs account.

Then you need to connect this account with your GitHub account. Once this is done you can import the projects that have sphinx documentation.

Usage

Once the ReadTheDocs and GitHub account are connected, the documentation pushed on the github repository is automatically compiled and published on the ReadTheDpcs web site.

It is worth to use the sphinx rtd theme as it provides an excellent rendering both on computer screens but also on tablet or smart phones.

Documentation

The web site is rather easy to use, but if you need documentation for specific topics you can have a look at ReadTheDocs documentation.