This repo generates the landing page for UDST documentation, hosted at http://docs.udst.org and https://udst-docs.readthedocs.io.
ReadTheDocs.org builds and hosts the Sphinx page defined in docs/source/index.rst. Builds are triggered when the master branch of this Github repo changes.
The page is built using the Sphinx documentation generator. Here's a good tutorial. Edit index.rst and conf.py to change what appears on the page.
Install sphinx and sphinx_rtd_theme.
From the docs directory, run sphinx-build -b html source build to build the documentation. HTML files will show up in docs/build/.
The build files won't be committed to the repo; ReadTheDocs will create a separate copy when the master branch is updated.
Hosting settings are at https://readthedocs.org/projects/udst-docs/. If you don't have access, create a ReadTheDocs account and ask one of the existing maintainers to add you.
The DNS settings for the docs.udst.org subdomain contain a CNAME record redirecting traffic to readthedocs.io. ReadTheDocs handles the SSL certificate for https.
Other UDST projects whose documentation uses this domain (e.g. ChoiceModels) have to be marked in ReadTheDocs as "subprojects" of the landing page.