[ros-dev] Proposal for a new "Documentation Management" group

Jerry crashfourit at gmail.com
Sun Jan 29 06:17:54 CET 2006

This is one the best Ideas I've seen for this poject. I second it.

Wierd_w wrote:

>Just an idea to kick around--
>With the recent issues of reverse engineering, and our
>new-- extra stern-- IP policy, it appears that
>"cleanroom implementation" (US style) is going to be
>very strictly adhered to.  This raises a few concernes
>to me, even though I dont develop code.
>1) The developers that decide they will become(Stay)
>reverse-engineers are going to have a great deal on
>their plate allready. Not only will they have to
>decompile proprietary binaries, but they will also
>have to make documentation about the functions within
>those binaries.  Asking them to manage the collective
>work of both themselves and other reverse engineers is
>asking too much.
>2) Implementors are not allowed to have direct
>communication with reverse engineers, under US style
>CleanRoom implementation practices. 
>So, I propose a new group classification, with the
>purposes of
>1) Organizing, catalogueing, and possibly correcting
>(For spelling, and other grammaticals) the whitepaper
>documentation produced by the reverse engineers.
>2) Offering the functional service of communicating
>with the reverse engineers any objections, or concerns
>the implementors might have. (EG, "XXXX XXXX does XXX
>XXX by YYYYY" is not sufficent to explain what is
>going on, can I get a better description?", the
>documentation manager group would contact the reverse
>engineer in question, and ask them to make an adendum
>to their documentation to address this issue, and
>would then contact the implementor after such
>addendum(s) have been completed, and filed.)
>This group would thus have responsibilities simmilar
>to "Editor", "Librarian", and "Secretary", which is
>why I propose the generic name "Documentation
>If there is allready such a position/group, I withdraw
>the proposal. Otherwise, I dont see how we could
>really hope to pull this off without dedicated
>individuals on this task.
>(PS, having "non-Coders" on this taskforce would
>probably alleviate any allegations of contamination
>between reverse engineers and Implemntors, in that it
>is unlikely that the secretary in question would
>understand a very technical request to begin with, and
>thus be unable to pass on any such complicated
>requests in their duties as secretary. It would also
>give some really strong enthusiasts something to do--
>All you need are clerical and communication skills.)
>Do You Yahoo!?
>Tired of spam?  Yahoo! Mail has the best spam protection around 
>Ros-dev mailing list
>Ros-dev at reactos.org

More information about the Ros-dev mailing list