82ecf8a416
- Change the layout and contents of docs to be better organised and follow ideas from: https://www.divio.com/blog/documentation/ - Use markdown for non-technical documents to speed up writing. - Added new sections and imported documents from Trac wiki. Build fixes: - Added a patch to fix recommonmark 0.4 and doc referencing: https://github.com/rtfd/recommonmark/issues/93 - Set docs build in tox to Py2.7 since there are problems with autodoc mocking multiple inheritance on Python 3 resulting in metaclass errors. - Supressed warning about `modules.rst` not in the toctree by creating a static `modules.rst` with `:orphan:` file directive and add to git. Also skip creating this toc file with sphinx-apidoc in setup and tox. - Simplified finding exported RPC and JSON API methods by adding an autodoc custom class directive. Removed unneeded __rpcapi.py.
15 lines
287 B
Markdown
15 lines
287 B
Markdown
# Documentation contributions
|
|
|
|
## Build
|
|
|
|
We use Sphinx to create the documentation from source files and docstrings in code.
|
|
|
|
pip install -r requirements-docs.txt
|
|
python setup.py build_docs
|
|
|
|
The resulting html files are in `docs/build/html`.
|
|
|
|
## man pages
|
|
|
|
Located in `docs/man`
|