discuss: Linux documentation
Subject:
Re: [discuss] Linux documentation
From:
Michael Kerrisk ####@####.####
Date:
23 Sep 2007 06:41:46 +0000
Message-Id: <46F60A72.4080400@gmx.net>
Dan Scott wrote:
> As someone who has spent some time on the PHP documentation team -
> maintaining the user notes (weeding out incorrect or complete spam
> notes) takes a massive amount of effort. Be prepared to invest a great
> deal of time weeding out the useless notes to try and ensure that only
> the useful notes remain, if you decide to go this route. I believe the
> PostgreSQL folks have had a similar experience. The idea is great, in
> an ideal world; in practice, it's very demanding.
Thanks for the data point(s). Over the last couple of years a few
people have suggested to me that I create a wiki for man-pages. I have
resisted out of concern over that very issue (plus there are many other
things that so far have taken a higher priority for man-pages).
Cheers,
Michael