On Mar 10, 2006, at 5:13 AM, Cris Daniluk wrote:
> Also, I entirely agree on leaving docs in the wiki. I don't even
> believe I'm biased by the time invested so far! Frameworks live and
> die by their documentation. Without dissing Apache or the project
> doc people, I don't think its a stretch to say that any list of the
> top 10 best documented frameworks doesn't include an Apache
> project :) I'd be inclined to say that it is because the patch
> process discourages participation from all but the most dedicated
> community members.
Exactly. The patch step may seem simple, but it is a HUGE barrier to
entry, especially to non-committers (but to committers as well). This
is from recent experience - until we deployed Confluence, we had doc
contribution levels close to zero. Even the people who wrote the code
were reluctant to document it properly.
Andrus
This archive was generated by hypermail 2.0.0 : Fri Mar 10 2006 - 01:06:04 EST