Status quo of Mercurial wiki

Andrew Lentvorski bsder at allcaps.org
Mon Nov 2 17:07:01 CST 2009


Adrian Buehlmann wrote:

> In any case, I should probably stop wasting my time
> on that horrible wiki then.

Nobody is saying *you, personally* are doing a poor job or that it is 
unwanted.

However, documentation is a large job.  It takes more than one person to 
do it without burning out, and the main developers have to decide that 
it is worth some of their time to "weed the garden" as well since 
they're some of the only people who understand how everything goes 
together in the big picture sense or some of the deeper technical issues.

A "Landing Page" is a nice thing, but it doesn't solve the underlying 
problem that the Wiki/Documentation needs regular attention from 
important people.  And, if the landing page starts expanding too much in 
scope, it will start taking the time of people away from improving the 
Wiki/Documentation.

Documentation always gets short shrift in open source projects (I'm as 
guilty as anybody).  This is nothing new.

-a


More information about the Mercurial mailing list