Doxygen

Instructions for the contributors

The Doxygen documentation pages are generated from the README.md files placed in the O2 directories.

The references between the Doxygen pages and subpages are achieved using a Doxygen page and subpage keywords. All README.md files must contain the Doxygen page tag on the top, and if the module contains other documentation pages (usually in its sub-directories), it must be linked using the Doxygen subpage tag. Special markdown comments are used to disable rendering of Doxygen keywords on GitHub.

When adding a new documentation page you must always add a \subpage declaration in an upper category page otherwise your page will pollute the "global" references in the left tab menu.

See the examples of README.md files both at the top and a submodule levels below, or follow this link if you are in Doxygen documentation.

The Modulename and Submodulename in the page and subpage tags must be identical (including case match) with the directories name.