# 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. #### An example of a `README.md` file in the O2 directories at the top level. ``` # The module title The paragraph(s) with the module description. ``` #### An example of a `README.md` file at a submodule level: ``` # The submodule1 title The paragraph(s) with the submodule description. ``` The `Modulename` and `Submodulename` in the `page` and `subpage` tags must be identical (including case match) with the directories name.