I realize I may be taking some liberties with the doc changes I'm making.
In my opinion, documentation is even more difficult to design by committee
than code is; at least with code there's one right way to do something, or
at least always a way better than an alternative. With documentation, the
most important thing is consistancy and clarity in prose, and those are two
things which reasonable people may disagree on.
Brian
--=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=--
pure chewing satisfaction brian@apache.org
brian@hyperreal.org
In my opinion, documentation is even more difficult to design by committee
than code is; at least with code there's one right way to do something, or
at least always a way better than an alternative. With documentation, the
most important thing is consistancy and clarity in prose, and those are two
things which reasonable people may disagree on.
Brian
--=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=--
pure chewing satisfaction brian@apache.org
brian@hyperreal.org