David Crossley wrote:
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.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.
2. Even after separating the blocks, presumably none of the work to clean up the javadoc will be wasted.
