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

[Jerry]

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
> Manager(s)."
>
>
> 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 
> http://mail.yahoo.com 
> _______________________________________________
> Ros-dev mailing list
> Ros-dev(a)reactos.org
> http://www.reactos.org/mailman/listinfo/ros-dev
>
>   
>