Hosted at: https://rootex.readthedocs.io/
Use normal Doxygen style comments in C++ code. Refer the Doxygen Documentation page on comments for more information.
In Rootex, we try to keep our documentation as short and brief as possible so that the Doxygen comments don't oppress what the code is saying. Don't say things that the code has already said.
We prefer adding /// This is a some piece of documentation
style comments to our source code to keep the C++ files as small as possible.
Describe the API design and usage in the .h files: that's the public interface for users.
Describe the implementation alternatives/issues and decisions in the .cpp files: that's for yourself later and other maintainers/enhancers, even someone reviewing the design as input to some next-gen system years hence.
-
Pre-requisites: Doxygen
-
Navigate to this directory.
cd docs/
- Install Python3 dependencies.
pip3 install -r requirements.txt
- Start the documentation builder.
.\make.bat html
- Open the homepage in your browser.
start build/html/index.html