[ 
https://issues.apache.org/jira/browse/SOLR-6520?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14134139#comment-14134139
 ] 

Alexandre Rafalovitch commented on SOLR-6520:
---------------------------------------------

I could argue about this, except you are linking to the WIKI from those same 
pages already. So, all you are doing, is giving a preferential treatment to 
WIKI instead. And, if the users do - somehow - manage to find the reference 
guide from the Google search, the problem you described has not gone away.

So, I would still say, link to the reference guide wherever you have a wiki 
link right now and mention the future-looking status in brackets. Link to the 
PDF for the active version next to it, to make it easier for the people on the 
old version.

I thought the current state was due to somebody missing the obvious. Now, it 
looks like a case of premature DE-optimization. :-)

> Documentation web page is missing link to live Solr Reference Guide
> -------------------------------------------------------------------
>
>                 Key: SOLR-6520
>                 URL: https://issues.apache.org/jira/browse/SOLR-6520
>             Project: Solr
>          Issue Type: Improvement
>          Components: documentation
>    Affects Versions: 4.10
>         Environment: web
>            Reporter: Alexandre Rafalovitch
>            Priority: Minor
>              Labels: documentation, website
>
> The [official document page for 
> Solr|https://lucene.apache.org/solr/documentation.html] is missing the link 
> to the live Solr Reference Guide. Only the link to PDF is there. In fact, one 
> has to go to the WIKI, it seems to find the link. 
> It is also not linked from [the release-specific documentation 
> page|https://lucene.apache.org/solr/4_10_0/index.html] either.
> This means the search engines do not easily discover the new content and it 
> does not show up in searches for when people look for information. It also 
> means people may hesitate to look at it, if they have to download the whole 
> PDF first.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

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

Reply via email to