To update PsyNet’s documentation first change into your project’s
docs directory, e.g.:
docs directory and its subdirectories contain files in rst format which stands for reStructuredText. See this primer which introduces the most basic syntax elements of reStructuredText documents. For a detailed reference check out the complete technical specification.
Once you have made changes to one or more rst files compile them into html files by executing
Adding or deleting files additionally requires the deletion of the
_build directory for the links in the menu to be updated accordingly:
rm -r _build make html
Now open the file
_build/html/index.html in your browser and have a look at the results.
On completion of updating the documentation commit the corresponding rst files only. The compiled html files in the
_build directory should be left ignored by Git.