Skip to content

OSC/ood-documentation

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OOD Documentation

Build Status GitHub License Documentation License

Usage

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

Or select your version:

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

Default - Docker/Podman

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

Make with Pip/python

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

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)