> What a whiner ;-) j/k, honest, I perceive the Devil's advocacy
> role. It is true, most OS projects suffer from this, but only
> from an outsider's point of view. The people who develop the
> stuff and use it all the time, DO NOT NEED DOCUMENTATION.
> People who do not participate, DO. So it is thus purely an exercise
> in altruism on the developers' part.
I think that good documentation ===> polish. After all, end users, and hey,
even people who use it all the time, don't see the code for all it's
competency of design; they have no idea what's going on. What they do see
is documentation. And if the docs "sUx0r!" then what impression do they
get? "If the container is 1/2 as shoddy as the docs, screw it." I know...
I know... who cares if they use it or not, hey it's their loss, etc.
Plus, I take it as a challenge. It's tough to write good, clean docs that
please the majority. As well, you're helping people, and you're improving
the image of the project to boot.
> Really, though, if there were just a central e-mail to send snippets
> and paragraphs, I'm sure a lot of people like me would probably
> enjoy sending in small submissions.
But for how long? As well, how about for the 1000th time someone asks? =)
- r
