cocoon-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Carsten Ziegeler <>
Subject Re: The Cocoon documentation: a lot has happened here
Date Fri, 03 Nov 2006 08:18:14 GMT
Great work!

Is there any possibility to change the order of the navigation items,
for example, if you look at:

The first main topic is about blocks and further down the list is the
core. I think this should be the other way round, especially as the
blocks stuff is not finished yet.


Reinhard Poetz wrote:
> 2 weeks ago, Arje posted a long list of things that need to be improved with our
> website and documentation. I can't say that all the things are resolved but
> Helma and I have made good progress:
>   - Following the split up of Cocoon (the code) we also split up the
>     documentation into much smaller pieces. The rule is that each deployment
>     unit has it's own documentation.
>   - Publishing our docs to will be 4 steps that have to be
>     performed at the shell at (see
> Thanks Vadim for
>     your help with that!
>     I think that's a good compromise between fast turn-around-cycles and
>     following the policy of having all our website content in SVN.
>   - The Daisy Maven plugin is in place and is able to extract the content of
>     our CMS.
>   - The documentation is automatically exported to
> every 4 hours.
>     This export can also be triggered off from the Continuum web app.
>     Go to and
>     rebuild the "$cdcos" project.
>   - Ross and I added news items to the homepage. As Ross explained, this list
>     is created dynamically by a query.
> At you can find how-tos 
> (about adding and publishing docs) and an overview of how the documentation 
> system works.
>                                     - o -
> In my opinion the technical problems are mostly solved. The next step is filling
> the CMS with content. In particular we should focus on two sites
>   - cdocs-main-site (
>   - cdocs-core (
> Then it's time to publish the new docs. WDYT?
> Of course, this shouldn't prevent you from working on the many other sites 
> (forms, template, flowscript etc.) if you think that your work is more efficient 
> there.
>                                     - o -
> Helma will also work on a new flashy design for our site, though we both don't 
> think that this effort should block publishing the docs using the "well-known" 
> Maven skin as soon as the content is good enough. Does anybody disagree?
>                                     - o -
> As many people agreed that it is *very important* to have good documentation, 
> Helma and I hope that others join us. Don't hesitate if you think that all this 
> stuff is complicated. It's definitly not! Just go to 
>, choose the site that you want to improve 
> and do it!

Carsten Ziegeler - Chief Architect

View raw message