(Illustration by Gaich Muramatsu)
On 4/13/05, Stephen J. Turnbull <stephen_at_xemacs.org> wrote: > >>>>> "Patrick" == Patrick Walsh <pwalsh_at_esoft.com> writes: > > Patrick> Another thought on documentation: many large projects, > Patrick> such as PHP, allow users to add comments on the end of > Patrick> each manual page or section. > > Zope does this as well for the Zope Book, but as far as I can tell > nobody does anything about maintaining the comments sections. Most of > them are now long, and basically useless (despite there being almost > no spam, not even ads for companies promoting Zope-related products). > It's a good idea, but somebody needs to commit to maintaining those > sections. Also, they need to be fairly fine-grained. > > In the absence of spam, a long list of useful comments should be OK. In my experience with the MySQL manual, its usually Google that leads me to an individual comment that addresses my question. > -- > School of Systems and Information Engineering http://turnbull.sk.tsukuba.ac.jp > University of Tsukuba Tennodai 1-1-1 Tsukuba 305-8573 JAPAN > Ask not how you can "do" free software business; > ask what your business can "do for" free software. > > -- http://www.cs.cmu.edu/~ntoliaReceived on 2005-04-14 01:36:19