- 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
Go to https://osc.github.io/ood-documentation/master/ to see the latest published release version.
Or select your version:
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.
- Use the Docker image that is used to build them in production using Travis.
- 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 ood-documentation-build container image. They are built using the following command from the root of this repo:
Note that because we're using rake
, you'll need to have ruby
installed on your
system as well as the rake
gem.
rake build
The default way to build these files are to use the container (instructions above)
that has all the dependencies sorted out. If however you'd rather install all
the dependencies through python's pip
(or a different python package manager
like conda
, venv
and so on) you can use the requirements.txt
found in the
ood-documentation-build
repository.
However this may be flaky and/or brittle way to manage this which is why using a container is the default mechanism for building these html files.
make html
Bug reports and pull requests are welcome on GitHub at https://github.com/OSC/ood-documentation.
- Documentation, website content, and logo is licensed under CC-BY-4.0
- Code is licensed under MIT (see LICENSE.txt)