Martin Maney wrote:

>On Thu, Nov 11, 2004 at 02:22:10PM -0500, Graham Fawcett wrote:
>
>
>>Seriously: perhaps moving the Quixote documentation to the Wiki would be
>>a good idea. Then, "write it yourself" would be a decent and meaningful
>>reponse to "the documentation is lacking".
>>
>>
>
>Nope, hardly ever.  The lesser reason is that writing documentation
>that's worth the pixels to display it isn't easy, but that's a problem
>the wiki might in fact help with.  Depends on who puts what effort into
>it.  The big problem is that the person complaining about a lack in (or
>of) the documentation is in no position to write it - if he understood
>it already, he wouldn't have needed the lacking documentation, eh?
>
>
Granted, Martin. My response was that of a lazy person, and one who
underdocuments his work. ;-) You're right: documentation writing is not
best left to those who are struggling to discover a system (though these
folks can make valuable contributions by identifying holes in existing
docs).

If not the Wiki, then what? Perhaps it would make sense to fold the
Quixote documentation into CVS? Developers are not always the best
documenters, but at least CVS would provide a consistent platform for
checking in changes to documentation as well as code changes.

those-who-cannot-write-docs-write-code-instead'ly yours,

-- G