Reinhard Poetz wrote:
Thien wrote:
Do you expect us picking one design and you continue from there?
I did a bit of vote counting, #2 and #3 are sharing the same amount of
first choice votes but #3 is ahead overall (with second choice votes).
What I'll do next is to improve #3 a little and we are good to
implement it. Is that ok?
fine by me
Thien,
I'm not sure if anybody has pointed you yet to the new documentation which is in
some ways different to what you can find at http://cocoon.apache.org. Have a
look at http://cocoon.zones.apache.org/dev-docs/. Especially I want to draw your
attention to following things:
- Each deployment unit has its own consistent documentation, e.g.
http://cocoon.zones.apache.org/dev-docs/core-modules/core/2.2/ or
http://cocoon.zones.apache.org/dev-docs/blocks/forms/1.0/489_1_1.html
At the upper right corner you can find the name of the current documentation
unit.
- we have a main menu containing "Cocoon Core", "Subprojects", Cocoon Blocks"
and "Maven plugins". This has to appear on each and every page as it is the
only way to jump between documentation units.
- The homepage currently consists of the "getting started - getting better -
getting involved" table, the news, an overview of the main versions and
a general explanation of what Cocoon actually is. These pieces of
information should find their space in the new homepage design too. IMO
the "Getting ..." table should be the eye-catcher number 1.
- The left-hand navigation can be up to 4 levels deep.
- Although I would like to have it, it is difficult for us to
maintain a "breadcrump navigation" like
Apache Cocoon > Cocoon Blocks > Cocoon Forms > [Introduction]
as we can't auto-generate them using existing (meta) data. As long as we
don't have a good idea of how to do it, we should avoid having one.
If you have questions, don't hesistate to ask!
--
Reinhard Pötz Independent Consultant, Trainer & (IT)-Coach
{Software Engineering, Open Source, Web Applications, Apache Cocoon}
web(log): http://www.poetz.cc
--------------------------------------------------------------------