incubator-general mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Niall Pemberton <niall.pember...@gmail.com>
Subject Re: Publishing api docs for Subversion
Date Fri, 04 Dec 2009 19:55:21 GMT
On Fri, Dec 4, 2009 at 5:29 PM, Doug Cutting <cutting@apache.org> wrote:
> Paul Querna wrote:
>>
>> <http://httpd.apache.org/docs/trunk/>
>>
>> Which is linked from the sidebar everywhere, and on the docs page:
>> <http://httpd.apache.org/docs/>
>
> That trunk documentation is at least labelled "dev".  I'd argue it should
> only be linked to from http://httpd.apache.org/dev/ and that it should
> reside there.  That would be consistent with:
>
> http://www.apache.org/dev/release.html#what
>
> "Do not include any links on the project website that might encourage
> non-developers to download and use nightly builds, snapshots, release
> candidates, or any other similar package."
>
> Documentation that's released is released under the Apache license and is
> not in general strongly distinguished from code that's released: we require
> a CLA on file for documentation contributions, we require each documentation
> source file to contain the license, etc.  Publishing trunk documentation to
> the non-developer portion of a web site is encouragement for non-developers
> to use trunk, which is something we should avoid.

It might be good a good idea to not confuse users trying to find docs
that relate to a release from that of of the current trunk, but its
doing incubating projects a disservice to try and make out that
release policy cover the docs they publish on their web site. This is
something for the project to decide for themselves and we should keep
our noses out and avoid trying to find new ways to beat them up with
policy.

Niall

> Doug

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


Mime
View raw message