cvs commit: ports/graphics/djvulibre Makefile ports/textproc/wordnet Makefile

[Chuck Swiger]

[ ...rampant cross-posting trimmed somewhat... ]

WARNING: Contains asbestos.  Do not eat.  This message has been carefully 
sanitized of all personal references to avoid taking sides.

Ceri Davies wrote:
> On Fri, Jul 15, 2005 at 12:23:33AM +0200, Michael Nottebrock wrote:
>> On Friday, 15. July 2005 00:09, Ceri Davies wrote:
>>> Disclaimer: I have not been following, nor do I wish to back up and
>>> read, the argument.
>>
>> Perhaps following discussions like these more often would help avoiding our 
>> documentation becoming stale like that.
> 
> Holy fuck, where did I ask for that?  Perhaps documenting the odd
> feature when it gets added would help too.  Later.

As entertaining as this has been, it doesn't seem useful for the people who 
write code and the people who try to document that code to argue.  Some people 
are good at coding, some are good at documentation, and a few do both 
especially well.

If you've written code and failed to document it properly, you should be 
thankful when someone figures your stuff out well enough to document it so that 
a normal user can use it.  If you're changing code that already has 
documentation in a way that makes the documentation no longer correct, and you 
fail to change the documentation yourself, it's not particularly useful to 
expect the docs to magicly update themselves, now is it?

-- 
-Chuck