Documentation for yarom is housed in two locations:
- In the top-level project directory as
- As a Sphinx project under the
To add a page about useful facts concerning C. elegans to the documentation, include an entry in the list under
and create the file
worm-facts.rst under the
docs directory and add a line:
to the top of your file, remembering to leave an empty line before adding all of your wonderful worm facts.
You can get a preview of what your documentation will look like when it is published by running
sphinx-build on the docs directory:
sphinx-build -w sphinx-errors docs build_destination
The docs will be compiled to html which you can view by pointing your web browser at
build_destination/index.html. If you want to view the documentation locally with the ReadTheDocs theme you’ll need to download and install it.
API documentation is generated by the Sphinx autodoc extension. The format should be easy to pick up on, but a reference is available here. Just add a docstring to your function/class/method and add an
automodule line to
PyOpenWorm/__init__.py and your class should appear among the other documented classes.
Project-wide substitutions can be (conservatively!) added to allow for easily changing a value over all of the documentation. Currently defined substitutions can be found in
conf.py in the
rst_epilog setting. More about substitutions
If you’d like to add a convention, list it here and start using it.
Currently there are no real conventions to follow for documentation style, but additions to the docs will be subject to style and content review by project maintainers.