On 9 Jun 2005, at 15:25, Sylvain Wallez wrote:

Mark Leicester wrote:

Getting started with Cocoon
+ Installing the prerequisites
  + Java
+ Getting the latest release of Cocoon
  + Downloading a Cocoon release



+ Getting Cocoon from the source repository
  + Installing and configuring your IDE
    + Eclipse
      + Subclipse
  + Checking out Cocoon
    + Using the command line
    + Using Subclipse


Honestly, this section should IMO go into an "advanced topics" section, as beginners really don't want to use the latest and greatest directly from svn...

And my impression is that explaining this in the first pages of a "getting started" is more frightening than useful :-)


Sounds good to me. I'm talking about refactoring what is already there. At the moment there is only "Getting Started". We can split it into more top-level trees as you suggest, maybe like:

Getting started with Cocoon
+ Installing the prerequisites
  + Java
+ Getting the latest release of Cocoon
+ Building and running Cocoon
  + From the command line

Advanced Cocoon configuration
+ What's in cocoon.xconf?
  + ...
+ What's in web.xml?
  + ...
+ Logging

Contributing to Cocoon
+ Getting Cocoon from the source repository
  + Installing and configuring your IDE
    + Eclipse
      + Subclipse
  + Checking out Cocoon
    + Using the command line
    + Using Subclipse
+ Building and running Cocoon
  + From the command line
  + From within Eclipse

Reply via email to