[
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: [email protected]
For additional commands, e-mail: [email protected]
