incubator-general mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Paul Querna <>
Subject Re: Publishing api docs for Subversion
Date Thu, 03 Dec 2009 22:14:52 GMT
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:

> In particular, I think it's a bad practice to publish automatic nightly
> builds on the official website of content that's otherwise the subject of
> release votes.  Is it forbidden?  Perhaps not, but it's not a practice we
> should encourage in the incubator.  Often documentation includes code.  Do
> we want to publish that code without a vote?

httpd docs don't include code, dunno what projects do :)

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

View raw message