cocoon-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Diana Shannon <shan...@apache.org>
Subject Re: Documentation Format...
Date Mon, 18 Nov 2002 12:05:59 GMT

On Monday, November 18, 2002, at 02:45  AM, Bertrand Delacretaz wrote:

>
>> . . .
>> Well, if the effort needed was granular enough, we might get more
>> help/resources.
>> . . .
>
> I think the concept of man pages (one page for each component)using 
> javadocs
> tags (as proposed by several people here) is a nice way of making the 
> effort
> more granular.

Yes, but....., I don't consider it a panacea (cure-all) for docs. It's 
really a subset of granular info or topics that can be used by other 
docs. Because it's so tied to the code, it doesn't necessarily cover the 
range of topics needed by other docs.

Diana


Mime
View raw message