Are you interested in what style is being proposed for documenting libprocess? (And subsequently, there is a good chance that more of Mesos source code may be enhanced in the same way.) If so, please check out my most recent comment in this ticket:
https://issues.apache.org/jira/browse/MESOS-2501 <https://issues.apache.org/jira/browse/MESOS-2501> The core of the matter is: shall we adopt JavaDoc style or “///“ style? I have put some pros and cons into the JIRA discussion. Please contribute more (good:-) reasons to decide either way or a third way! (Note that this discussion is in anticipation of later getting to doxygenize some interface-level source code while we are currently focussing on a libprocess User Guide, first, because this promises to have (even) more utility in the short term.) Bernd
