From d564851059813836454f275e9b735f9068cf32c6 Mon Sep 17 00:00:00 2001 From: Jeremy Bowman Date: Mon, 14 May 2018 09:42:59 -0400 Subject: Add tox environment for docs --- docs/developer-guide.txt | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) (limited to 'docs/developer-guide.txt') diff --git a/docs/developer-guide.txt b/docs/developer-guide.txt index b2c1a0ce..85210055 100644 --- a/docs/developer-guide.txt +++ b/docs/developer-guide.txt @@ -106,10 +106,12 @@ Setuptools follows ``semver``. Building Documentation ---------------------- -Setuptools relies on the Sphinx system for building documentation. -To accommodate RTD, docs must be built from the docs/ directory. +Setuptools relies on the `Sphinx`_ system for building documentation. +The `published documentation`_ is hosted on Read the Docs. -To build them, you need to have installed the requirements specified -in docs/requirements.txt. One way to do this is to use rwt: +To build the docs locally, use tox:: - setuptools/docs$ python -m rwt -r requirements.txt -- -m sphinx . html + $ tox -e docs + +.. _Sphinx: http://www.sphinx-doc.org/en/master/ +.. _published documentation: https://setuptools.readthedocs.io/en/latest/ -- cgit v1.2.3