You can read the most up to date documentation online at this link: http://openhatch.readthedocs.org/en/latest/index.html
The documentation source files can be found in the docs/ folder of the oh-mainline repository: https://github.com/openhatch/oh-mainline/tree/master/docs
reStructuredText and Sphinx¶
We encourage you to help improve the OpenHatch documentation. We have a Documentation Style Guide which gives an overview of our basic documentation style and guidelines.
Changing or Adding Documentation¶
Before making any changes, we recommend taking a moment to read the Documentation Style Guide.
Making changes to documentation via pull request¶
To see the changes rendered locally, you can run the render_docs.py script found in the tools folder of the oh-mainline repository:
You will find the documentation rendered into html format inside the docs/html folder of the oh-mainline repository. You can view it in your browser and check that you like your changes before submitting them. (Again, see Git Basics for help submitting your changes.)
Once you submit your changes as a pull request and they have been merged by a maintainer, they will appear in the openhatch/oh-mainline repository. The openhatch.readthedocs.org/ files will update automatically via a github web hook.
If you've create a new file or edited/deleted a "toctree", you may get an error "WARNING: document isn't included in any toctree". This means a file is not referenced by a table of contents anywhere. Consider adding it to one. See Sphinx guide or reference.)
Making changes to documentation via readthedocs/Github editor¶
If you're having trouble navigating the documentation by opening and editing files locally, you can also try paging through the readthedocs. Each page should have an 'Edit on Github' link in the righthand corner. When you click this link, Github will automatically create a fork of the project for you (if one does not automatically exist). Once you finish editing, make sure to submit a pull request.