You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@lucene.apache.org by Alexandre Rafalovitch <ar...@gmail.com> on 2014/03/27 10:26:24 UTC
Wiki: Solr API Javadoc magic redirector
Hello,
On the following page, there is a Javadoc link that redirects to 404:
https://wiki.apache.org/solr/DataImportHandler#EventListeners
The link is: http://lucene.apache.org/solr/api/org/apache/solr/handler/dataimport/EventListener.html
It redirects (incorrectly) to:
http://lucene.apache.org/solr/4_7_0/solr-core/org/apache/solr/handler/dataimport/EventListener.html
It should redirect to:
https://lucene.apache.org/solr/4_7_0/solr-dataimporthandler/org/apache/solr/handler/dataimport/EventListener.html
The issue is the module name (solr-core vs. solr-dataimporthandler).
What is this magic redirector and is it just dumb (e.g. always
redirects to solr-core) or broken?
Regards,
Alex.
Personal website: http://www.outerthoughts.com/
Current project: http://www.solr-start.com/ - Accelerating your Solr proficiency
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org
RE: Wiki: Solr API Javadoc magic redirector
Posted by Alexandre Rafalovitch <ar...@gmail.com>.
Any way to export the whole wiki then to look at URLs in bulk?
Regards,
Alex
On 27/03/2014 8:43 pm, "Uwe Schindler" <uw...@thetaphi.de> wrote:
> Hi,
>
>
>
> the redirects for solr-core were only added to temporary fix the most
> common mistakes after we moved to a new directory structure for java docs.
> We should remove them asap, once the links pointing there are fixed. These
> redirects don’t work for all cases, its just something like “buest guess
> 80/20”.
>
>
>
> We should better fix the links in the wiki:
>
> In general the Wiki should have links like
> http://lucene.apache.org/solr/api/...., which is redirected to the actual
> released version released (/api/ => /4.7.1/). The above special case should
> be fixed to use this “persistent link”, including the correct module path.
>
>
>
> Uwe
>
>
>
> -----
>
> Uwe Schindler
>
> H.-H.-Meier-Allee 63, D-28213 Bremen
>
> http://www.thetaphi.de
>
> eMail: uwe@thetaphi.de
>
>
>
> *From:* Cassandra Targett [mailto:casstargett@gmail.com]
> *Sent:* Thursday, March 27, 2014 2:08 PM
> *To:* dev@lucene.apache.org
> *Subject:* Re: Wiki: Solr API Javadoc magic redirector
>
>
>
> I dug in a little and found it's a set of redirects defined in .htaccess
> for lucene.apache.org. It's a rather basic set of rules. The rule that's
> doing this specific redirect is redirecting every URL that has
> '/solr/api/org/(.*)' to '/solr/4_7_0/solr-core/org/$1'. (One of the release
> tasks is to update this file for each release, so that will soon be 4_7_1.)
>
> I don't have any great ideas for how to fix it. I looked for an example
> from another non-solr-core feature (like solr-uima, solr-cell, or
> solr-clustering), but couldn't find anything that matched this case. I
> suppose another rule could be added and the URL in the page changed, but
> I'd of course want to do that in a way that's supportable over the
> long-term.
>
> An immediately obvious answer is to add a rule to redirect
> '/solr/api/dataimport/(.*)' to '/solr/4_7_0/solr-dataimporthandler/$1' (and
> then change the link to the Javadoc to
> http://lucene.apache.org/solr/api/dataimport/org/apache/solr/handler/dataimport/EventListener.html<http://lucene.apache.org/solr/api/org/apache/solr/handler/dataimport/EventListener.html>),
> but I'm not sure that makes long-term sense - we'd have to have a rule for
> each of the various contribs and that is maybe a pain to maintain? I don't
> know if there's something else that's simpler that I'm not aware of.
>
> Anyone have any other ideas?
>
>
> Cassandra
>
>
>
>
>
> On Thu, Mar 27, 2014 at 4:26 AM, Alexandre Rafalovitch <ar...@gmail.com>
> wrote:
>
> Hello,
>
> On the following page, there is a Javadoc link that redirects to 404:
> https://wiki.apache.org/solr/DataImportHandler#EventListeners
>
> The link is:
> http://lucene.apache.org/solr/api/org/apache/solr/handler/dataimport/EventListener.html
> It redirects (incorrectly) to:
>
> http://lucene.apache.org/solr/4_7_0/solr-core/org/apache/solr/handler/dataimport/EventListener.html
> It should redirect to:
>
> https://lucene.apache.org/solr/4_7_0/solr-dataimporthandler/org/apache/solr/handler/dataimport/EventListener.html
>
> The issue is the module name (solr-core vs. solr-dataimporthandler).
>
> What is this magic redirector and is it just dumb (e.g. always
> redirects to solr-core) or broken?
>
> Regards,
> Alex.
>
> Personal website: http://www.outerthoughts.com/
> Current project: http://www.solr-start.com/ - Accelerating your Solr
> proficiency
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
> For additional commands, e-mail: dev-help@lucene.apache.org
>
>
>
RE: Wiki: Solr API Javadoc magic redirector
Posted by Uwe Schindler <uw...@thetaphi.de>.
Hi,
the redirects for solr-core were only added to temporary fix the most common mistakes after we moved to a new directory structure for java docs. We should remove them asap, once the links pointing there are fixed. These redirects don’t work for all cases, its just something like “buest guess 80/20”.
We should better fix the links in the wiki:
In general the Wiki should have links like http://lucene.apache.org/solr/api/...., which is redirected to the actual released version released (/api/ => /4.7.1/). The above special case should be fixed to use this “persistent link”, including the correct module path.
Uwe
-----
Uwe Schindler
H.-H.-Meier-Allee 63, D-28213 Bremen
<http://www.thetaphi.de/> http://www.thetaphi.de
eMail: uwe@thetaphi.de
From: Cassandra Targett [mailto:casstargett@gmail.com]
Sent: Thursday, March 27, 2014 2:08 PM
To: dev@lucene.apache.org
Subject: Re: Wiki: Solr API Javadoc magic redirector
I dug in a little and found it's a set of redirects defined in .htaccess for lucene.apache.org. It's a rather basic set of rules. The rule that's doing this specific redirect is redirecting every URL that has '/solr/api/org/(.*)' to '/solr/4_7_0/solr-core/org/$1'. (One of the release tasks is to update this file for each release, so that will soon be 4_7_1.)
I don't have any great ideas for how to fix it. I looked for an example from another non-solr-core feature (like solr-uima, solr-cell, or solr-clustering), but couldn't find anything that matched this case. I suppose another rule could be added and the URL in the page changed, but I'd of course want to do that in a way that's supportable over the long-term.
An immediately obvious answer is to add a rule to redirect '/solr/api/dataimport/(.*)' to '/solr/4_7_0/solr-dataimporthandler/$1' (and then change the link to the Javadoc to http://lucene.apache.org/solr/api/dataimport/org/apache/solr/handler/dataimport/EventListener.html <http://lucene.apache.org/solr/api/org/apache/solr/handler/dataimport/EventListener.html> ), but I'm not sure that makes long-term sense - we'd have to have a rule for each of the various contribs and that is maybe a pain to maintain? I don't know if there's something else that's simpler that I'm not aware of.
Anyone have any other ideas?
Cassandra
On Thu, Mar 27, 2014 at 4:26 AM, Alexandre Rafalovitch <ar...@gmail.com> wrote:
Hello,
On the following page, there is a Javadoc link that redirects to 404:
https://wiki.apache.org/solr/DataImportHandler#EventListeners
The link is: http://lucene.apache.org/solr/api/org/apache/solr/handler/dataimport/EventListener.html
It redirects (incorrectly) to:
http://lucene.apache.org/solr/4_7_0/solr-core/org/apache/solr/handler/dataimport/EventListener.html
It should redirect to:
https://lucene.apache.org/solr/4_7_0/solr-dataimporthandler/org/apache/solr/handler/dataimport/EventListener.html
The issue is the module name (solr-core vs. solr-dataimporthandler).
What is this magic redirector and is it just dumb (e.g. always
redirects to solr-core) or broken?
Regards,
Alex.
Personal website: http://www.outerthoughts.com/
Current project: http://www.solr-start.com/ - Accelerating your Solr proficiency
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org
Re: Wiki: Solr API Javadoc magic redirector
Posted by Cassandra Targett <ca...@gmail.com>.
I dug in a little and found it's a set of redirects defined in .htaccess
for lucene.apache.org. It's a rather basic set of rules. The rule that's
doing this specific redirect is redirecting every URL that has
'/solr/api/org/(.*)' to '/solr/4_7_0/solr-core/org/$1'. (One of the release
tasks is to update this file for each release, so that will soon be 4_7_1.)
I don't have any great ideas for how to fix it. I looked for an example
from another non-solr-core feature (like solr-uima, solr-cell, or
solr-clustering), but couldn't find anything that matched this case. I
suppose another rule could be added and the URL in the page changed, but
I'd of course want to do that in a way that's supportable over the
long-term.
An immediately obvious answer is to add a rule to redirect
'/solr/api/dataimport/(.*)' to '/solr/4_7_0/solr-dataimporthandler/$1' (and
then change the link to the Javadoc to
http://lucene.apache.org/solr/api/dataimport/org/apache/solr/handler/dataimport/EventListener.html<http://lucene.apache.org/solr/api/org/apache/solr/handler/dataimport/EventListener.html>),
but I'm not sure that makes long-term sense - we'd have to have a rule for
each of the various contribs and that is maybe a pain to maintain? I don't
know if there's something else that's simpler that I'm not aware of.
Anyone have any other ideas?
Cassandra
On Thu, Mar 27, 2014 at 4:26 AM, Alexandre Rafalovitch
<ar...@gmail.com>wrote:
> Hello,
>
> On the following page, there is a Javadoc link that redirects to 404:
> https://wiki.apache.org/solr/DataImportHandler#EventListeners
>
> The link is:
> http://lucene.apache.org/solr/api/org/apache/solr/handler/dataimport/EventListener.html
> It redirects (incorrectly) to:
>
> http://lucene.apache.org/solr/4_7_0/solr-core/org/apache/solr/handler/dataimport/EventListener.html
> It should redirect to:
>
> https://lucene.apache.org/solr/4_7_0/solr-dataimporthandler/org/apache/solr/handler/dataimport/EventListener.html
>
> The issue is the module name (solr-core vs. solr-dataimporthandler).
>
> What is this magic redirector and is it just dumb (e.g. always
> redirects to solr-core) or broken?
>
> Regards,
> Alex.
>
> Personal website: http://www.outerthoughts.com/
> Current project: http://www.solr-start.com/ - Accelerating your Solr
> proficiency
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
> For additional commands, e-mail: dev-help@lucene.apache.org
>
>