The current documentation based on these sources can be seen at: http://www.opsschool.org/
If you have arrived here, you are probably interested in helping out. So thank you for your time.
Things you should know:
This is the only Markdown file in the repository, as it's not meant to be included in the documentation itself.
If you are looking to add content, fix formatting, syntax, typos or other wonderful things, please follow this process:
pip install -r requirements.txt(This is best done in a virtual environment.)
opsschool/curriculumrepository to your own account
git checkout --branch <my_topic>
make htmlto build the docs in to
make htmlagain and verify your changes don't cause any warnings/errors
If you submit a pull request and would like to have your name associated with
the project, add it to the
Some cool things:
vim-commoncontains a reStructuredText syntax highlighter
When creating a link to another page inside the curriculum, use Sphinx's built-in cross-reference mechanisms to achieve this.
linking to a top-level document such as "Text Editing 101" should be done inline, like so:
See :doc:`text_editing_101` for details...
where the name provided is the RST file path. The title will be linked to the document like so:
See <em>Text Editing 101</em> for details...
linking to a reference point, such as a sub-topic on a page should be done by creating a globally unique reference point, such as:
.. _gnu-screen: GNU Screen ----------
and using this inline anywhere in the docs like so:
See :ref:`gnu-screen` for more details.
The sub-topic's title will be replaced in the hyperlink as well.
After modifications to links, please run
make linkcheck to see the status of
all the links in the docs.
More on cross-referencing can be read in the Sphinx Docs.