[Fwd: Re: Switching out Cocoon]

[Nicola Ken Barozzi <ni...@apache.org>]

What do Forresters think of this?

IMHO we will do something similar to what Forrest is doing now, ie have 
two versions of the site.
We have xml.apache.org/forrest that is generated and uploaded by hand, 
versus an hourly built www.krysalis.org/forrest.

When we want, we can push the site in production; else it will happen 
like in all projects where the coders don't even want to know how to 
generate the site.
Look at the state of jakarta-site2.
Look at the state of xml-site!!! :-O

-------- Original Message --------
Subject: Re: Switching out Cocoon
Date: Fri, 09 Aug 2002 00:25:02 +0900
From: Leif Mortenson <le...@tanukisoftware.com>
Reply-To: "Avalon Developers List" <av...@jakarta.apache.org>
To: Avalon Developers List <av...@jakarta.apache.org>
References: <00...@Gabriel> 
<3D...@apache.org> <3D...@tanukisoftware.com> 
<3D...@apache.org>

Nicola Ken Barozzi wrote:

 > Cocoon is more powerful, has docs crawling and Forrest, which uses
 > Cocoon, will soon make sites updates automatic from a bot, as is
 > happening already for a couple of projects out of Apache.

Automatic updates are something that sounds sexy.  But I would be a
strong -1 on implemenenting that.

The online site documentation is a product of Avalon.  It is where
people come to learn how to use the
code that we all work so hard to create.  The online site needs to
always be working and needs to always
look good.   This is a lot more important than keeping it up to date
with the latest code on a nightly basis.

If the build is working.  Then people who are on CVS can build docs from
CVS as well.

We do not come anywhere close to asking the average user to use nightly
builds.  Why would we want
them to view the nightly build of our documentation?

When you try out a piece of code and it crashes.  You don't come back.
  Well our users view the site
long before they even look at our code.   It is more important that it
works than for it to be super sexy.

Which reminds me I need to document the instrument packages :-/

Leif


--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>




-- 
Nicola Ken Barozzi                   nicolaken@apache.org
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------