I would like to add the following to: https://community.kde.org/Frameworks/Frameworks_Documentation_Policy#Document_the_Classes
One can use [https://www.doxygen.nl/manual/commands.html Doxygen commands] to improve readability, for example * @c which will make the word after it use a monospace/typewriter font face, typically e.g. @c true, @c false, @c setSomeValue(); for multiple words you'll have to use:
<pre><tt>multiple words</tt></pre> * @copydoc to copy the docs of a different method, e.g. if one method overloads another -- Ahmad Samir