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 (JIRA)" <ji...@apache.org> on 2014/09/19 18:24:35 UTC

[jira] [Comment Edited] (SOLR-6520) Documentation web page is missing link to live Solr Reference Guide

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

Alexandre Rafalovitch edited comment on SOLR-6520 at 9/19/14 4:24 PM:
----------------------------------------------------------------------

I do not want to confuse two issues: the current status of WIKI vs. the Reference Guide and the fact that people - right now - are not finding the Reference Guide. I do know of the year-long TODO and participated in some of the discussions on the mailing list.

All I am saying is that Reference Guide is great, yet is not discoverable easily. Which is a shame and disservice to the community after so much work was and is put into that. So, I am proposing an easy solution in the meanwhile, while the WIKI issue is being sorted out.

I think it is important to separate us - people who have worked with Solr for a while - and new Solr users. They will not know or want to know the legacy history. They just want to be pointed to the most up-to-date information. The rest is our internal ongoing work.

As to the proposed link, it could be just:
{panel}
<URL>(Solr Reference Guide), Note: the live version of the Guide reflects latest version of Solr. Versions of the guide reflecting released versions of Solr are available as a  <URL>(PDF version).
{panel}


was (Author: arafalov):
I do not want to confuse two issues: the current status of WIKI vs. the Reference Guide and the fact that people - right now - are not finding the Reference Guide. I do know of the year-long TODO and participated in some of the discussions on the mailing list.

All I am saying is that Reference Guide is great, yet is not discoverable easily. Which is a shame and disservice to the community after so much work was and is put into that. So, I am proposing an easy solution in the meanwhile, while the WIKI issue is being sorted out.

I think it is important to separate us - people who have worked with Solr for a while - and new Solr users. They will not know or want to know the legacy history. They just want to be pointed to the most up-to-date information. The rest is our internal ongoing work.

As to the proposed link, it could be just:
```
[URL](Solr Reference Guide), Note: the live version of the Guide reflects latest version of Solr. Versions of the guide reflecting released versions of Solr are available as a  [URL](PDF version).
```

> 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-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org