Contributing

This project is maintained on our Pagure repository. Contributions are reviewed and accepted by submitting a pull request to our Pagure repository. If you're not familiar with the pull request workflow, check out the Pagure documentation on pull requests.

Documentation is written in reStructedText. See Sphinx's reStructuredText Primer for a brief introduction to the concepts and format.

Local Builds

To build the documentation locally, create a virtualenv and install the requirements:

$ sudo dnf install python-virtualenvwrapper
$ mkvirtualenv -a $(pwd) infra-docs
$ pip install -r requirements.txt

Then build the documentation and open it in a browser of your choice:

$ cd docs
$ make html
$ firefox _build/html/index.html

Use SPHINXOPTS variable to pass build arguments to Sphinx. For example to recheck sources for warnings:

$ make html SPHINXOPTS="-n -E"

To leave the virtual environment:

$ deactivate

Finally, when you want to work on the documentation, you can re-enter the virtual environment with:

$ workon infra-docs

It will automatically change the current working directory to the repository root.