deckhand/doc/source
Felipe Monteiro 0cd5d45706 Add sphinx job for auto-generating docs
Sphinx can be leveraged to auto-generate docs into feature-rich
HTML pages. Docstrings in modules and classes can be easily
auto-injected into documentation to produce high-level
documentation, yet with accompanying code blocks and
necessary docstrings.

This commit introduces the tox job for auto-generating docs,
as well as the foundational logic and documentation pages
(index, HACKING and glossary). While hacking rules are
introduced in HACKING.rst, they are not added in this
commit; that will be done in a follow-up patchset.

Additional documentation will also be included in a series
of future patchsets.

Change-Id: Iacd0e4542ebf481d66ab19dd43014b8d5bcc9e3f
2017-09-21 16:16:23 +01:00
..
_static Add sphinx job for auto-generating docs 2017-09-21 16:16:23 +01:00
HACKING.rst Add sphinx job for auto-generating docs 2017-09-21 16:16:23 +01:00
conf.py Add sphinx job for auto-generating docs 2017-09-21 16:16:23 +01:00
glossary.rst Add sphinx job for auto-generating docs 2017-09-21 16:16:23 +01:00
index.rst Add sphinx job for auto-generating docs 2017-09-21 16:16:23 +01:00