Mailing-List: contact java-dev-help@lucene.apache.org; run by ezmlm
Precedence: bulk
Reply-To: java-dev@lucene.apache.org
Received-SPF: pass (athena.apache.org: domain of cutting@gmail.com designates
 74.125.92.25 as permitted sender)
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=message-id:date:from:user-agent:mime-version:to:subject:references
         :in-reply-to:content-type:content-transfer-encoding:sender;
        b=FJ9cfz5lcawucLpCzDu2+Cc/CctzQ74ezTXuvEcZZ7EjNwUYPvlN5ULzNBD062xkY8
         F9L/wKcuECHSt3hEefWuGZ8G+zVZt8EQlfmKUqsrtXJssHJ1AeJcQpVraphVuRScdbW7
         iIgL1lTNd8xG/zzJS7ZB3T8W0uP4owehFUFUg=
Message-ID: <49148A71.2050100@apache.org>
Date: Fri, 07 Nov 2008 10:35:29 -0800
From: Doug Cutting <cutting@apache.org>
User-Agent: Thunderbird 2.0.0.17 (X11/20080925)
MIME-Version: 1.0
To: java-dev@lucene.apache.org
Subject: Re: Broken javadocs->site docs links
References: <9294E20AED46934EA459020706463F94EF42CD@SUEXCL-02.ad.syr.edu>
In-Reply-To: <9294E20AED46934EA459020706463F94EF42CD@SUEXCL-02.ad.syr.edu>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Sender: Doug Cutting <cutting@gmail.com>

Steven A Rowe wrote:
> This would not entirely fix the issue; each version's javadocs should link to the same version of the site docs, rather than to the latest version (which is what I assume you mean here).  

Right.  The javadocs should use a relative link to point to versioned 
docs.  But, if releases have been made and broken links to absolute urls 
are in the wild, we can patch that with .htaccess.

> Are you arguing that the trunk javadocs should not be published anywhere at all?

I've mostly given up on that battle...  Developers by definition can 
build their own javadocs, and a link, even from the developer part of 
the site, gives nightly builds more legitimacy.  If folks really want, 
they can find and bookmark the nightly link on Hudson.

But, back to the issue at hand, fixing broken links in the javadocs on 
Hudson seems like a low priority.

Doug

---------------------------------------------------------------------
To unsubscribe, e-mail: java-dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-dev-help@lucene.apache.org