> -----Original Message-----
> From: Niclas Hedhman [mailto:[EMAIL PROTECTED]
> 
> Sorry, I can only find negatives with the 'LSD' approach, and I think
> we should employ a different mechanism.

First off, it isn't just LSD's approach:
  http://www.apache.org/dev/committers.html#web

Secondly, before anyone commits anything into /avalon/site or even
/avalon/central/site, they should review the changes.  It doesn't have to be
on the web server before you can check.  *NO* system is going to protect us
from bad commits.

> The build system uploads the 'new site' to
> avalon.apache.org/[revnumber] so that the site can go live 'for a
> while' first.

This still requires the build system to have a way to upload to
/www/avalon.apache.org/[revnumber].  Currently that means ssh access which
means a unix account which is exactly what we're trying to avoid.

Cons about the current approach:
   1. We're storing the generated HTML in SVN.
   2. There can be a discrepancy between the XML and HTML documents in SVN.
   3. Site updates are done on a "dumb" schedule: normal cron, not triggered
      by some sort of change or release mechanism
   4. Roll-backs and fixes not trivial or immediate

Pros about the current approach:
   1. Requires only one cron job and a relatively light weight 
      update process (svn update is easy on the CPU)
   2. Generation process agnostic:  it doesn't matter if you use
      Maven, Forrest, Docbook, or straight HTML authoring.  The
      current mechanism expects ready-to-go HTML not needs-to-be-processed 
      XML.
   3. Changes to XML source are not published until the generated HTML is
      copied over and committed (ie- release control)

An ideal system would:

   1. Generate the site from XML automatically 
   2. Allow for scheduled and on-demand releases
   3. Allow for roll-backs
   4. Allow for intelligent updates: ie- don't need to copy over everything
      for a small change; don't unnecessarily delete old content;...
   5. Not require any unix shell access
   6. Scale for all the ASF projects (and their various generation schemes)

If you want to put together a test case for the
/www/avalon.apache.org/[revision] system, go ahead and use your
www.apache.org/~niclas site to test it out and we can see how well it works.

J. Aaron Farr
  SONY ELECTRONICS
  STP SYSTEMS
  (724) 696-7653

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to