Although I don't use the pdf version I highly recommend watching Cassandra's 
talk from Activate last year ( https://m.youtube.com/watch?v=DixlnxAk08s). In 
this talk she addresses the challenges of the Solr ref guide including the 
'title search' mentioned below and presents a number of options for the guide's 
future.  It certainly gave me an appreciation for some of the complexities in 
this part of the Solr project that I'd never fully appreciated before.

The guide has come a long way since the confluence days and continues to evolve 
with every release. Although the title search is not ideal I'm yet to not find 
anything I'm looking for with a little creative googling.

That's my tire cents on the matter.
________________________________
From: Alexandre Rafalovitch <arafa...@gmail.com>
Sent: Tuesday, 29 October 2019 9:11 AM
To: solr-user <solr-user@lucene.apache.org>
Subject: Re: Solr Ref Guide Changes - now HTML only

I've done some experiments about indexing RefGuide (from source) into
Solr at: https://github.com/arafalov/solr-refguide-indexing . But the
problem was creating UI, hosting, etc.

There was also a thought (mine) of either shipping RefGuide in Solr
with pre-built index as an example or even just shipping an index with
links to the live version. Both of these were complicated because PDF
was throwing the publication schedule of. And also because we are
trying to make Solr distribution smaller, not bigger. A bit of a
catch-22 there. But maybe now it could be revisited.

Regards,
   Alex.
P.s. A personal offline copy of Solr RefGuide could certainly be built
from source. And it will become even easier to do that soon. But yes,
perhaps a compressed download of HTML version would be a nice
replacement of PDF.

On Tue, 29 Oct 2019 at 09:04, Shawn Heisey <apa...@elyograg.org> wrote:
>
> On 10/28/2019 3:51 PM, Nicolas Paris wrote:
> > I am not very happy with the search engine embedded within the html
> > documentation I admit. Hope this is not solr under the hood :S
>
> It's not Solr under the hood.  It is done by a javascript library that
> runs in the browser.  It only searches page titles, not the whole document.
>
> The fact that a search engine has terrible search in its documentation
> is not lost on us.  We talked about what it would take to use Solr ...
> the infrastructure that would have to be set up and maintaned is
> prohibitive.
>
> We are looking into improving things in this area.  It's going a lot
> slower than we'd like.
>
> Thanks,
> Shawn

Reply via email to