incubator-general mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Hyrum K. Wright" <hyrum_wri...@mail.utexas.edu>
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 <cutting@apache.org> 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.
> 
> <http://httpd.apache.org/docs/trunk/>
> 
> Which is linked from the sidebar everywhere, and on the docs page:
> <http://httpd.apache.org/docs/>

Back the original question: What's the best/typical way of generating and providing these
documents?  Subversion 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.

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


Mime
View raw message