So you want to write a tutorial or a similar prose documentation text. Simply do the following:
Look at the header menu of this page. Decide in which section your document should appear. For example, the “About Shark” section.
Navigate to your Shark base directory. From there to doc/sphinx_pages/rest_sources, and then into the subdirectory that corresponds to the site section you chose in the previous step. For example, $SHARKHOME/doc/sphinx_pages/rest_sources/about_shark.
Create an empty file with a meaningful name for your new document, ending on .rst. For example, new_text.rst.
Write your documentation text in the reStructuredText markup language. See the original documentation here and the primer included in the Sphinx documentation there. In addition to the standard syntax, Sphinx adds special markup constructs. Alternatively, navigate to an existing html file on the Shark homepage, press “Show page source” on the right and copy along.
Almost finished! We only need to “register” your new document with the Sphinx system. Usually this is done by adding the relative path to the toctree directive at the top of $SHARKHOME/doc/sphinx_pages/index.rst. In our example, we’d add the line
to the top of index.rst. In rarer cases, the page is included locally from another sub-page. Note that the page will only be included in the Sphinx navigation tree if a toctree directive on the top of the page is used, so exploit this peculiarity consciously.
If you want to look at your page, do a make html in $SHARKHOME/doc/sphinx_pages or a make doc in $SHARKHOME. Some warnings about non-included documents are expected (unrelated: in rare cases a make clean html seems to be necessary). Then open $SHARKHOME/doc/sphinx_pages/build/html/rest_sources/about_shark/new_text.html in your browser – done!