cocoon-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From David Crossley <cross...@apache.org>
Subject Re: [docs] "docs" Ant target
Date Fri, 11 Mar 2005 00:28:24 GMT
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

Mime
View raw message