Upayavira wrote: > Reinhard Poetz wrote: > >David Crossley wrote: > <snip/> > > >>The other thing to bear in mind, and this was one of the big hold-ups > >>in the past with improving the docs, is that all of the docs are also > >>generated via the Cocoon webapp ... 'cocoon.sh servlet'. They use old > >>stylesheets that are probably dependent on an old version of xdocs DTD. > >>I don't have any answer to that. > > > >I don't think we need this anymore. "forrest webapp" is more than a > >replacement for people who want to see the docs "live". > > Well, I really _don't_ like the idea of not shipping HTML docs with a > distribution, whether that is shipping ready made HTML, or as viewable > via Cocoon. Telling a beginner who wants to read the docs offline that > he has to go and download Forrest to find out how Cocoon works is just > not acceptable.
I agree with Upayavira. A smart framework like Cocoon should be able to render its own docs, even if with no trimmings and just a flat navigation menu down the left-hand side. --David
