user-docs

Documentation for using an InterMine webapp.

Documentation

The HTML documentation is generated from RST source, using a Python static site generator called Sphinx. RST stands for reStructuredText (see reference). When you push to the GitHub repo for these docs, this triggers a new build of the documentation site, where the changes will be visible within a few minutes. This process is managed by ReadTheDocs, an online service for maintaining documentation.

Building locally

You should build locally before you push, to make sure your changes are correct. You will need the Sphinx environment for this. Make and Python (only version 2 is supported) are required, and we recommend using virtualenv to manage dependencies:

Setting up:

cd docs
virtualenv .
source ./bin/activate
pip install 'sphinx==1.7.9'

Building the docs:

# In the docs directory
make html

Theming

The source for the Sphinx documentation theme can be found in the intermine/design-materials repo.