incubator-general mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Branko ─îibej <>
Subject Re: Publishing api docs for Subversion
Date Mon, 07 Dec 2009 21:41:27 GMT
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?

The question is /which/ developers. If you insist that trunk
documentation is for contributors to the project only ... then I beg to
differ. It's a very useful resource. Making it harder to find is less
than friendly.

On the other hand, in this day of massive search engines, it doesn't
really matter where you put the generated documentation -- it gets
indexed one way or another. Unless you're now going to say that the dev/
part of the site alsy needs its own robots.txt that prevents indexing by
search engines. :)

-- Brane

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

View raw message