Coda File System

Re: Improving Coda documentation

From: Niraj Tolia <ntolia_at_gmail.com>
Date: Thu, 14 Apr 2005 01:34:31 -0400
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/~ntolia
Received on 2005-04-14 01:36:19