Go to https://osc.github.io/ood-documentation/master/

Or select your version:

• Development
• Latest Stable
• 1.1
• 1.0

There are two ways to build the documentation.

1. Use the Docker image that is used to build them in production using Travis.
2. Use pipenv to install local dependencies. pipenv has become the recommended package to use by python.org for dependency management

Currently all builds are generated using the docker-sphinx Docker image. They are built using the following command from the root of this repo:

docker run --rm -i -t -v "${PWD}:/doc" -u "$(id -u):$(id -g)" ohiosupercomputer/docker-sphinx make html

Or use the rake task added:

rake docker:build

If you don't want to use Docker, you can also use pipenv.

1. Ensure plantuml and graphviz are installed:

   # on OS X
   brew install plantuml
   brew install graphviz

2. Install pipenv and use it to install dependencies in same directory:

   pip install -g pipenv
   
   # then in the documentation root directory:
   WORKDIR=/doc PIPENV_VENV_IN_PROJECT=1 pipenv install
   
   # or using handy rake task:
   rake pipenv:install

When building the docs, run this command:

WORKDIR=/doc PIPENV_VENV_IN_PROJECT=1 pipenv run make html

or use the rake task:

rake pipenv:build

# or

rake build

Bug reports and pull requests are welcome on GitHub at https://github.com/OSC/ood-documentation.

The gem is available as open source under the terms of the MIT License.