<div dir="ltr">Hi Folks,<div><br></div><div>As I was trying to make sure I was using the right documentation conventions for some things I&#39;m working on, I started to prepare some attempted clarifications to submit as a Gerrit change, but I realized I didn&#39;t know enough yet.</div><div><br></div><div>I opened Redmine issue 2139 to collect feedback and suggestions before proceeding to propose changes no one wants.</div><div><br></div><div>In particular, I was hoping to clarify the use of doxygen sections versus groups as well as to look for ideas on how one might finagle doxygen to more clearly note which API level each data structure or function is exposed in. I&#39;m not sure if doxygen generalizes the &quot;tag&quot;s it uses for &quot;private&quot; and &quot;inline&quot; and such, or whether there is another easy way to add a badge or text formatting to the documented entities.</div><div><br></div><div>If you have any thoughts, please let me know.</div><div><br></div><div>Cheers,</div><div>Eric</div></div>