How to host a privately owned documentation with ReadTheDocs or Sphinx

The only thing you need to host sphinx documentation is a static file server (the search works without a back end, see my answer here. That said, using a private readthedocs server is probably over-engineering. Just deploy the files to a static file server and point the base URL (e.g. docs.myapp.com) to the index.html file. … Read more

How can I link/reference another reST file in the documentation?

To create links between different reStructuredText (.rst) files you can use the inline markup provided by sphinx. See the documentation under the heading Cross-referencing documents on top of the file you define its label .. _my-reference-label: then you can link to it from other documents using :ref:`my-reference-label`. I do not believe you need to use … Read more