Mailing-List: contact general-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: general@incubator.apache.org
Received-SPF: pass (nike.apache.org: domain of jukka.zitting@gmail.com
 designates 209.85.218.210 as permitted sender)
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=mime-version:in-reply-to:references:from:date:message-id:subject:to
         :content-type:content-transfer-encoding;
        b=si/ZitWuGkZ/2hREgY8wCIYhJBTid4pSWwVKwxBglMVj4eBeZXGerJCPCYRE3KdU2m
         Sc6HC18pN/5WJCHFR1LczC6cWs5g76qe0Cam2OVI5oviaWQI16AuwuKxVy6xfIgJQ3hp
         h4Fq/RbcHOIpEe7kPa5uLhin1af4zNONsFn0A=
MIME-Version: 1.0
In-Reply-To: <4dc6c9040912031918x6eb7702x119f3a1399cff53f@mail.gmail.com>
References: <4dc6c9040912020948j5ccbb31wf61da8ee3c5e9124@mail.gmail.com>
	<4B16AF4F.8090601@apache.org>
 <4239a4320912021809u177f080ai208e2d18846168ad@mail.gmail.com>
	<4B17F5FB.3010003@apache.org>
 <4239a4320912031414i528d4e13n74447bb26f522654@mail.gmail.com>
	<2CFCBE46-7916-47B1-BB80-05309AA2221F@mail.utexas.edu>
 <4dc6c9040912031918x6eb7702x119f3a1399cff53f@mail.gmail.com>
From: Jukka Zitting <jukka.zitting@gmail.com>
Date: Fri, 4 Dec 2009 09:42:12 +0100
Message-ID: <510143ac0912040042n528f9d87h5d30816ada812786@mail.gmail.com>
Subject: Re: Publishing api docs for Subversion
To: general@incubator.apache.org, bhuvaneswaran@gmail.com
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable

Hi,

On Fri, Dec 4, 2009 at 4:18 AM, Bhuvaneswaran A <bhuvaneswaran@gmail.com> w=
rote:
> On Fri, Dec 4, 2009 at 4:23 AM, Hyrum K. Wright
> <hyrum_wright@mail.utexas.edu> wrote:
>> Back the original question: What's the best/typical way of generating
>> and providing these documents? =A0Subversion is using svnwcsub to
>> publish subvesion.apache.org, but I don't think it's reasonable to check
>> in a copy of the API documentation.
>
> To add to it and if i was not clear in my original email, when I say
> "update docs on nightly basis", I mean updating the files every night.
> It does not mean generating new set of doc files every night.

Some Apache projects are now using Hudson builds to generate their web
sites from sources stored in svn. The generated site is periodically
rsynced to the correct place people.apache.org. This setup is still a
bit experimental but should cover your needs pretty well.

The infra@ and site-dev@ archives are not public so I unfortunately
can't point you to the relevant threads there, but see for example
http://markmail.org/message/6m5jwauk77krla5k for a related description
of how the Apache Tika web site is currently handled.

Please join the site-dev@ mailing list for more details and ideas on
how to improve the setup.

BR,

Jukka Zitting

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org