Documentation toolchain#
ArviZ documentation is built using a Python documentation tool, Sphinx.
Sphinx converts rst
(restructured text) files into HTML websites.
There are different extensions available for converting other types of files
like markdown, jupyter notebooks, etc. into HTML websites.
ArviZ docs consist of .rst
, .md
and .ipynb
files.
It uses myst-parser
and myst-nb
for .md
and .ipynb
files.
Apart from the content in the /doc/source
folder, ArviZ documentation also consists of docstrings.
Docstrings are used in the .py
files to explain the Python objects parameters and return values.
ArviZ docs also uses sphinx extensions for style, layout, navbar and putting code in the documentation.
A more detailed overview of the sphinx toolchain used at ArviZ is available at Sphinx primer for ArviZ and PyMC contributors