cocoon-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From David Crossley <cross...@indexgeo.com.au>
Subject Re: Forrest docs in old format.
Date Fri, 24 Oct 2003 09:07:06 GMT
David Crossley wrote:
> Antonio Gallardo wrote:
> >
> > I noted almost all the docs in Cocoon website is in the "old" document v10
> > of Forrest:
> > 
> > <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN"
> > "../dtd/document-v10.dtd">
> > 
> > Can we change to the "new" format v12?
> 
> Yes, but there is a problem. We could change all the docs to v1.2
> and the generation of docs via 'build docs' should be okay.
> 
> However, remember that docs are also built via the webapp
> localhost:8888/docs/
> and this still uses stylesheets that are specific to v1.0
> 
> http://wiki.cocoondev.org/Wiki.jsp?page=ForrestProposal
> ... this identifies some of the issues. The complexity is probably
> why no-one has been brave enough to do this job yet.

Perhaps we can solve this dilemma by avoiding it. We could
remove the docs generation stuff from the webapp. If people
want to do live docs, then they could install Forrest and
'forrest run' on another port. We already ask them to install
Forrest if they want to 'build docs'.

--David





Mime
View raw message