DragonFly docs List (threaded) for 2005-04
Re: Wiki and docs in cvs
The hard parts with writing docs are getting started, keeping the
and having a ready environment to encourage a contribution when time and
That's a general concept. You could say the same thing about code, but
this week's bugfix-only time isn't hurting anything, for instance.
If we don't have known, planned periods for cleanup, what other quality
checks can we put in? There's no review process before something's added.
I'm not sure we actually have a formal review process on the Wikified
docs *at all*,
(pre or post)... and we should.
But reviewing is (generally) a slightly different skillset than the
writing, and I don't even know if the toolset we are using makes a
submit/approve process easy or difficult.
Going forward, we need both the mechanism, (probably easy) and the
That may be harder to satisfy if the best (only?) qualified reviewers
have to stop coding to peruse submissions.
No easy answers here, just a belief that shortage of docs is presently
more of a problem than syncing what we do have.