README.md

OOD Documentation

• Website: http://openondemand.org/
• Documentation: https://osc.github.io/ood-documentation/master/
• Main code repo: https://github.com/OSC/ondemand
• Core library repo: https://github.com/OSC/ood_core
• Original repo with JOSS publication: https://github.com/OSC/Open-OnDemand

Usage

Go to https://osc.github.io/ood-documentation/master/ to see the latest published release version.

Or select your version:

• Development
• Latest Stable
• 1.6
• 1.5
• 1.4
• 1.3
• 1.2
• 1.1
• 1.0

Development

Open pull requests to the develop branch, which is the main branch of this repo. This repo uses the gitflow branching model.

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

Docker

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/ood-doc-build make html

Or use the rake task added:

rake docker:build

Contributing

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

License

• Documentation, website content, and logo is licensed under CC-BY-4.0
• Code is licensed under MIT (see LICENSE.txt)