forrest-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Piroumian Konstantin <KPiroum...@protek.com>
Subject RE: [Fwd: Re: Switching out Cocoon]
Date Thu, 08 Aug 2002 15:40:14 GMT
> From: Nicola Ken Barozzi [mailto:nicolaken@apache.org] 
> 
> What do Forresters think of this?

There can be a main page where you can choose either the release or the
nightly build docs. Just like it is done in Tomcat's or Struts' sites.

Konstantin

> 
> 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 <leif@tanukisoftware.com>
> Reply-To: "Avalon Developers List" <avalon-dev@jakarta.apache.org>
> To: Avalon Developers List <avalon-dev@jakarta.apache.org>
> References: <002801c23ee5$17e71bd0$ac00a8c0@Gabriel> 
> <3D527C59.8020906@apache.org> <3D52878B.3080502@tanukisoftware.com> 
> <3D528917.5010805@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:   
> <mailto:avalon-dev-unsubscribe@jakarta.apache.org>
> For 
> additional commands, e-mail: 
> <mailto:avalon-dev-help@jakarta.apache.org>
> 
> 
> 
> 
> -- 
> Nicola 
> Ken Barozzi                   nicolaken@apache.org
>              - verba volant, scripta manent -
>     (discussions get forgotten, just code remains)
> ---------------------------------------------------------------------
> 

Mime
View raw message