incubator-general mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Hyrum K. Wright" <>
Subject Re: Publishing api docs for Subversion
Date Thu, 03 Dec 2009 22:53:01 GMT

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 unsubscribe, e-mail:
For additional commands, e-mail:

View raw message