incubator-general mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Bhuvaneswaran A <>
Subject Re: Publishing api docs for Subversion
Date Fri, 04 Dec 2009 03:18:51 GMT
On Fri, Dec 4, 2009 at 4:23 AM, Hyrum K. Wright
<> wrote:
> On Dec 3, 2009, at 2:14 PM, Paul Querna wrote:
>> On Thu, Dec 3, 2009 at 9:31 AM, Doug Cutting <> wrote:
>>> Paul Querna wrote:
>>>> httpd and apr have published doxygen of their trunks periodically,
>>>> they aren't based on any release.
>>> Were these published these on the official public website or in the dev/
>>> section?
>>> I was under the impression that released documentation should be treated
>>> similarly to released code.  The convention I've used is that stuff that's
>>> in trunk, stuff that's intended to be included in releases, is only
>>> published after release.  Other pages on the website that are not included
>>> in releases, e.g., the project's home page, are clearly published without a
>>> release vote.
>> <>
>> Which is linked from the sidebar everywhere, and on the docs page:
>> <>
> Back the original question: What's the best/typical way of generating and providing these
documents?  Subversion is using svnwcsub to publish, 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. Overall
we'll maintain just one copy that is updated every night. I wish there
should be a place other that site/ area in repository, if is not apt.

Bhuvaneswaran A
GPG: 0x7A13E5B0

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message