[
https://issues.apache.org/jira/browse/SOLR-6520?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14140706#comment-14140706
]
Cassandra Targett commented on SOLR-6520:
-----------------------------------------
I've been heads down on another project and am just catching up with this
today...
bq. you are linking to the WIKI from those same pages already
A couple of points of explanation about that: First, those are frequently a
legacy thing from when the ref guide was not part of the Solr/Lucene project.
Second, the wiki needs to be updated page-by-page to reflect the status of the
ref guide as the official documentation for Solr. That's been a year+ -long
TODO that we all want but no one has yet had a lot of time for. The thought is
that the wiki will become a place where people can add tips & tricks, etc. -
stuff that's not "documentation" per se, but still really valuable. When that
happens, the links to the wiki make a lot more sense - with some changed
wording - and why it's not a huge priority to systematically remove them today.
bq. link to the reference guide wherever you have a wiki link right now and
mention the future-looking status in brackets.
I'm not following exactly - could you give me an example of what you mean?
> 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]
