Mailing-List: contact dev-help@stdcxx.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@stdcxx.apache.org
Received-SPF: pass (athena.apache.org: domain of msebor@gmail.com designates
 209.85.198.232 as permitted sender)
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=message-id:date:from:user-agent:mime-version:to:subject:references
         :in-reply-to:content-type:content-transfer-encoding;
        b=kzKcpRWmx+MIAWHFguaRHWbAoX0/ij2qsEvOUQ1RbsfckLXgzfu28qv6xrmerFM/9o
         PtYIXImChZtHAjEp23MdR7swEzLUnofVKfExBi/T8e0CFnCCdM3nMvbU4kw3+6weNR2J
         Fv+Fd57K3EuWtJzWH2PRYyl3DmP+BnlCBsHgM=
Message-ID: <48A781AE.1070804@gmail.com>
Date: Sat, 16 Aug 2008 19:41:02 -0600
From: Martin Sebor <msebor@gmail.com>
User-Agent: Thunderbird 2.0.0.16 (X11/20080723)
MIME-Version: 1.0
To: dev@stdcxx.apache.org
Subject: Re: Website Layout
References: <945707.1201827547692.JavaMail.jira@brutus>
 <63203.124.169.96.181.1201840274.squirrel@www.e-wire.net.au>
 <47A2B563.2010209@roguewave.com> <001f01c864ab$f3da62e0$0200a8c0@developer>
 <CFFDD219128FD94FB4F92B99F52D0A49010A3532@exchmail01.Blue.Roguewave.Com>
 <004101c867f2$16025fa0$0200a8c0@developer> <47A8DD67.5010205@roguewave.com>
 <005b01c8837b$4c72d7f0$0200a8c0@developer>
 <003901c8fa91$70a3e410$0200a8c0@developer> <48A0FA86.2090603@gmail.com>
 <002d01c8fc5e$655a20f0$0200a8c0@developer> <48A1DB05.9000501@gmail.com>
 <007b01c8fce7$16e217a0$0200a8c0@developer> <48A344D5.6060104@gmail.com>
 <002901c8fdfa$44ae8b00$0200a8c0@developer> <48A4DC8E.1060505@gmail.com>
 <005d01c8fe98$8cd9b0a0$0200a8c0@developer>
 <001901c8fffe$74b25740$0200a8c0@developer>
In-Reply-To: <001901c8fffe$74b25740$0200a8c0@developer>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit

Gavin wrote:
> 
>> -----Original Message-----
>> From: Gavin [mailto:gavin@16degrees.com.au]
>> Sent: Friday, 15 August 2008 3:34 PM
>> To: dev@stdcxx.apache.org
>> Subject: RE: Website Layout
>>
>> Hi Martin,
>>
>>> -----Original Message-----
>>> From: Martin Sebor [mailto:msebor@gmail.com]
>>> Sent: Friday, 15 August 2008 11:32 AM
>>> To: dev@stdcxx.apache.org
>>> Subject: Re: Website Layout
>>>
>>> Alright Gavin, thanks for your patience in discussing this.
>> No problem,
>>
>>> If you can point me at your sources I'll generate the HTML
>>> and commit the whole lot under
>>>    http://svn.apache.org/repos/asf/stdcxx/site/forrest
>>> as you suggest, and work on replacing the existing site
>>> with the generated docs.
>> I was working on it from your trunk, so I exported it and zipped it up as
>> exported.zip in my home dir on people (gmcdonald).
> 
> Would it work if I zipped up my versioned files? Could you then overwrite
> your versioned /forrest/ and svn up, never tried it before so don't know,
> just trying to make it easier.

I'm not sure I understand correctly what exactly you mean but
why don't we give it a try? If it doesn't work I'm sure we'll
find out ;-)

> 
>> Just to recap, you should put those sources in /site/forrest/ and the
>> generated html should end up /site/deploy/ or whatever names you want to
>> call them.
> 
> Well, as an update on the infra thread, it has revealed some sites deploy
> directly to their /www/$tlp.a.o/ directly. Joes has agreed to relax policy
> and allow this to continue. It also looks like (if volunteers emerge I
> guess) that a zone may eventually happen for projects to build sites on,
> before deploying to /www/$tlp.a.o/

I saw Joe's response and was going to follow up -- you beat me
to it :) I've never worked on these zones so I have no idea how
easy it will be to generate the docs there and then move them
over to people.a.o.

> 
> So, as it stands then, currently you still have to build offline, but you
> can then deploy your generated docs directly if you wish. It is worth
> reading the latest posts in the thread, especially Roys comments on why it
> is still good to deploy to svn and keep your published site files versioned.

In case someone hijacks the site.

FWIW, my biggest concern is having to manually generate the docs.
I tend to work on different servers with no Forrest or even Java
installed. Having to remember to go to a machine with the software
installed, set it all up (it's never set up by default), then run
the tool, and only then check the output in is a hassle I'd like
to avoid. Ideally, I was hoping to take this step out of the
equation for everyone by automating it on the ASF side. If that
can't be done for administrative or technical reasons I might
set it up on one of our servers instead, and either commit the
generated HTML automatically, or scp them to their destination
on people.a.o. I've seen objections to the former approach on
infra. The latter seems like a cleaner approach (no need to
check in generated files), but it's vulnerable to the problem
Roy points out. It doesn't seem like a solution that will make
everyone happy exists. No matter which we choose, it will be
a compromise...

Martin