I had a brainwave recently. Any Cocoon committer is able to now easily update the cocoon.apache.org website and you do not need Forrest installed locally.
When the forrestbot at our zone [1] finishes the Cocoon docs, it then tar-gzips them and makes them available for download. Copy them into your SVN working copy at https://svn.apache.org/repos/asf/cocoon/site/site/2.1 and svn commit. It is cumbersome because you get all docs, even though only a few have changed. It is worth it because this gets the important 2.1/changes.html out there. Note that Forrest is now portraying the contributors much more prominently. I modified the instructions at: http://wiki.apache.org/cocoon/CocoonWebsiteUpdate [1] http://forrest.zones.apache.org/ -David Ross Gardler wrote: > Niels van Kampenhout wrote: > >Ross Gardler wrote: > > > >>Niels van Kampenhout wrote: > >> > >>>Hmm. I understand from Arje that the documentation I refered to in my > >>>post is outdated and not updated anymore. The latest documentation > >>>apparently is at cocoon.zones.apache.org. To be honest, I was under > >>>the impression that the docs @ cocoon.apache.org are the latest from > >>>Daisy... > >> > >>This is incorrect. The published docs are the ones from Daisy. There > >>is a time lag between them being edited and them being published. How > >>long that lag is depends on when someone is able to publish them. > >> > >>The docs from Daisy are built once a day by the Forrestbot, see [1]. > >>These are not intended to be read by users, but are there so that devs > >>can verify the latest version of the docs before they are published to > >>the site. > >> > >>As for a link to the latest devlopment version of a doc in daisy, take > >>a look at the bottom of any page in the docs collection where you will > >>see the following text and link: > >> > >>"Errors and Improvements? If you see any errors or potential > >>improvements in this document please help us: View, Edit or comment > >>on the latest development version (registration required)." > > > >Oops, sorry, I was misinformed and didn't bother to check myself :-( > > > >Thanks for the clarification! Still I find it a bit confusing that there > > three publicly available URLs with potentially three different versions > >of the Cocoon documentation. > > How is it different from maintaing docs sources in SVN? In this case we > would have a location for the sources (SVN), a location for the staging > docs (local directory or a staging server) and a location for the public > docs (web). > > The way I see it is: > > Dev docs in daisy are equivalent to svn sources (i.e for the devs) > > Forrest zone (or locally created docs) are equivalent to locally created > docs from svn sources. These are for QA > > Published site is no different and is fo rthe end user. > > Ross
