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 Mon, 07 Dec 2009 22:34:18 GMT
On Mon, Dec 7, 2009 at 1:00 PM, Doug Cutting <> wrote:
> William A. Rowe Jr. wrote:
>> I suspect that renaming /docs/trunk/ to /docs/dev/ would be sufficient and
>> follow this best practice?
> I don't know how much folks look at the URL, but I think I've heard Roy
> indicate that all developer-specific stuff should be under a dev/ URL.
> I think it would be better yet not to link to it from the side bar, which
> appears on every page, but rather just from the
> page.  If the primary point of posting it is so that developers can refer to
> it without having to build it themselves, it doesn't need to be posted so
> prominently, does it?

But in a way, its still missing a point -- because the other
documentation URL,s, IE for 2.2.x, are direct subversion exports, with
no voting on their contents, so its really a branches/2.2.x/docs
instead of trunk/docs.

I think the stance being taken understandable, but I believe the
burden is being placed completely in the wrong direction.  Make things
easier to do, not harder.

IANAL, but whats so bad from the ASF liability standpoint that
requires voting on website content?  if there is ever a problem, we
pull it.....

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

View raw message