Jim Henderson wrote:

> It seems that companies think "if we put 
> a place for people to comment/write/wiki/whatever they'll just 
> participate" - and that's generally not the case.

It's not just companies. I lose track of how many Haskell libraries have 
"documentation" consisting only of a list of function names and their 
type signatures. And when you say "why is there no documentation?" the 
answer you get is "patches welcome".

In other words, "if you want to write my documentation for me, I'd be 
happy to include it in the next release". I guess distributed version 
control makes people lazy.

> That's a pet peeve of mine today - just software documentation in general 
> not being very high quality.

If it was only the *documentation* things wouldn't be so bad...

Post a reply to this message