cocoon-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Ralph Goers <Ralph.Go...@dslextreme.com>
Subject Re: [Proposal] review of sitemap component documentation
Date Wed, 24 Nov 2004 07:02:20 GMT
David Crossley wrote:

> Reinhard Poetz wrote:
>
>>
>> Go for it!
>>
>> We also have to consider that we have more independant blocks very 
>> soon, means that we have the goal that each block can be released 
>> seperatly and IMO it should provide its own docs.
>>
>> This seems to be the simple part. More difficult is providing a 
>> complete documentation consisting of Cocoon core and all blocks 
>> automatically ...
>
>
> Yeah, i thought a little about that wrinkle while
> devising that proposal. Don't know what the answer
> is yet. That is why i was asking if anyone was going
> to say: stop, we need to throw away or redesign that
> excellent SitemapTask to cope with separate bloack docs.
>
> Anyway, i think that reviewing the content of the
> current sitemap components docs is still worthwhile.
>
1. I don't believe the independent blocks will occur until 2.2 is 
released.  I believe 2.1 still has a long life ahead of it and making 
the documentation better needs to start there.
2. Even after separating the blocks, presumably none of the work to 
clean up the javadoc will be wasted.


Mime
View raw message