[ 
https://issues.apache.org/jira/browse/MESOS-2501?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14561475#comment-14561475
 ] 

Niklas Quarfot Nielsen commented on MESOS-2501:
-----------------------------------------------

I would love to kick this off again - it is a poor experience as a reviewer and 
as a contributor to miss existing (and great) abstractions because a 
random-walk of the source base isn't a great way to pick the right 
abstraction/tools and very few has a full picture of all  of them (and they may 
end up being duplicated!).

I would root for starting an effort to make turn all comments on public classes 
and methods to one of the doxygen styles (it's is a matter of taste, don't have 
a preference but we can start a poll to get a general idea).

> Doxygen style for libprocess
> ----------------------------
>
>                 Key: MESOS-2501
>                 URL: https://issues.apache.org/jira/browse/MESOS-2501
>             Project: Mesos
>          Issue Type: Documentation
>          Components: libprocess
>            Reporter: Bernd Mathiske
>   Original Estimate: 7m
>  Remaining Estimate: 7m
>
> Create a description of the Doxygen style to use for libprocess 
> documentation. 
> It is expected that this will later also become the Doxygen style for stout 
> and Mesos, but we are working on libprocess only for now.
> Possible outcome: a file named docs/doxygen-style.md
> We hope for much input and expect a lot of discussion!



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

Reply via email to