docs in a wiki [was Re: making review/bug filing optional for

timeless timeless at myrealbox.com
Mon Mar 21 13:03:21 UTC 2005


Tomas Kopal wrote:
> Well, what about treating wiki as sort of "landfill" of documentation? 

or graveyard. i don't have much experience with wikis (or blogs), but 
what i have seen is that figuring out what's changed and worth looking 
at is non trivial, and not better than using bonsai on cvs or a decent 
query of bugzilla/bu.gmail.

> Anyone can make an attempt to make the docs better, and some "reviewers" 
> will be overlooking the changes.

these are the same reviewers who barely have time to review requests 
from the wind and write their own code/docs ....

> Approval from any of the reviewers 
> would mean taking the changes from wiki and putting them back to the 
> docbook sources, which will be the only "official" documentation.

lots of additional work....

> It would be necessary to find a way how to propagate these changes from 
> wiki to docbook automatically, though.

sounds like a big problem waiting for someone to waste time on.



More information about the developers mailing list