summaryrefslogtreecommitdiff
path: root/tox.ini
diff options
context:
space:
mode:
authorJoshua Powers <josh.powers@canonical.com>2019-09-07 02:27:45 +0000
committerServer Team CI Bot <josh.powers+server-team-bot@canonical.com>2019-09-07 02:27:45 +0000
commit385232dc8da6532b54342cd11e6d822ff7cd3e5a (patch)
treeef0f51ecd8a348407cbea7662a3e55bc105e890d /tox.ini
parentc7688981e1070c75f3c3f31e707e7be272dd43d6 (diff)
downloadcloud-init-git-385232dc8da6532b54342cd11e6d822ff7cd3e5a.tar.gz
doc: document doc, create makefile and tox target
* Create makefile and tox targets for documentation building and testing to better replicate the live web docs using the same theme. * Created docs.rst to explain how to build and contribute to documentation with style guide and tips. * doc/rtd/conf.py:     * Add copyright to rtd config     * Use Sphinx's RTD theme to replicate actual docs
Diffstat (limited to 'tox.ini')
-rw-r--r--tox.ini9
1 files changed, 7 insertions, 2 deletions
diff --git a/tox.ini b/tox.ini
index 1f01eb76..f5baf328 100644
--- a/tox.ini
+++ b/tox.ini
@@ -53,8 +53,13 @@ exclude = .venv,.tox,dist,doc,*egg,.git,build,tools
[testenv:doc]
basepython = python3
-deps = sphinx
-commands = {envpython} -m sphinx {posargs:doc/rtd doc/rtd_html}
+deps =
+ doc8
+ sphinx
+ sphinx_rtd_theme
+commands =
+ {envpython} -m sphinx {posargs:doc/rtd doc/rtd_html}
+ doc8 doc/rtd
[testenv:xenial]
commands =