[OPEN-ILS-DOCUMENTATION] ***SPAM*** RE: Documentation Search, limit to documentation

[Josh Stompro]

Robert(If it was Robert that set it up), thanks for setting this up, looks good on the documentation site.

What do you think about adding the latest database schema as a scope also?  Right now the 2.4 and 2.3 schema files show up in results, but nothing newer since there are no links to them.

Also on the main site, I think some of the refinement labels are setup to only promote the results, not to limit.  The Bugs/Requests, Code Changes(OpenSRF),  labels are like that.  Maybe that is what you intended though.

And one other thing, when a search refinement tab is selected, the color scheme changes to a black text on a dark background, making it hard to read.
[cid:image002.png at 01CFDEDD.170F96B0]

Thanks
Josh

From: open-ils-documentation-bounces at list.georgialibraries.org [mailto:open-ils-documentation-bounces at list.georgialibraries.org] On Behalf Of Josh Stompro
Sent: Thursday, October 02, 2014 3:10 PM
To: Documentation discussion for Evergreen software
Subject: [OPEN-ILS-DOCUMENTATION] ***SPAM*** RE: Documentation Search, limit to documentation

Hello, this is to follow up on the discussion in the Dig meeting today about search scoping.

It looks like Google Custom Search can include scoping, they call it Refinements.
https://support.google.com/customsearch/answer/2631064?hl=en
https://developers.google.com/custom-search/docs/refinements

Refinements
Refinements are a way for you to categorize sites by topics. For example, if you have a bicycling search engine, you can have categories of, say, bike maintenance, bike reviews, bike stores, biking skills, and so on and so forth. You can create refinement labels that you associate with the sites you listed in the Sites tab. The refinement links appear at the top of your search results page, and users can click them to narrow down their searches. A search page can have as many as 16 refinement links.
To create a refinement label, click Add Refinement, and define the settings. To tag websites with labels, go to the Sites tab, select check boxes next to the sites, and select the label from the Label actions drop-down list. You can tag sites with more than one label.
Before you create your labels, you might want to check out existing labels<https://developers.google.com/custom-search/docs/ref_prebuiltlabels> and pool your resources with Google and other users.

I setup a new google custom search with labels for the evergreen sites to try it out and it seems to work pretty well.  I would like to figure out how to set a refinement as the default, but even if that doesn't work, it is still useful.
https://www.google.com/cse/publicurl?cx=007549852895470088378:zj5roh0k57s


[cid:image001.png at 01CFDEDB.C808D5A0]

I would be happy to help set this up if any help is needed/wanted.  It looks like Sub admin accounts can be added to the Google Custom Search - https://developers.google.com/custom-search/docs/admin_accounts

Thanks
Josh

From: open-ils-documentation-bounces at list.georgialibraries.org<mailto:open-ils-documentation-bounces at list.georgialibraries.org> [mailto:open-ils-documentation-bounces at list.georgialibraries.org] On Behalf Of Josh Stompro
Sent: Monday, September 15, 2014 11:56 AM
To: open-ils-documentation at list.georgialibraries.org<mailto:open-ils-documentation at list.georgialibraries.org>
Subject: [OPEN-ILS-DOCUMENTATION] Documentation Search, limit to documentation

Hello, I've found it confusing that the google site search that is in the header of the HTML version of the documentation searched the whole http://docs.evergreen-ils.org site, and not just the documentation that I'm currently viewing.

Would it be possible if the searching for each version of the documentation was limited to only that version?  If I'm using the search while I'm in version 2.6, then I'm expecting to just see results for that version.  Right now I see results for all versions available, in all formats.  So I'll get hits for the PDF version as well as the same info in the html version.  To me in makes the results redundant and less useful.

I can fix this manually when I need to by using the "site:http://docs.evergreen-ils.org/2.6 <searchterm> -filetype:pdf" format, but it would be nice if this was the default.  I cannot think of any reason to keep the PDF results in there since it is all redundant.

Maybe it could have radiobutton options under the search box to change the scope.  "X 2.6 docs only  O Entire Site  O Site + Wiki + Listarchives"

Thanks
Josh
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://list.georgialibraries.org/pipermail/open-ils-documentation/attachments/20141003/c07c48bc/attachment-0001.htm>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image001.png
Type: image/png
Size: 50735 bytes
Desc: image001.png
URL: <http://list.georgialibraries.org/pipermail/open-ils-documentation/attachments/20141003/c07c48bc/attachment-0002.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image002.png
Type: image/png
Size: 5363 bytes
Desc: image002.png
URL: <http://list.georgialibraries.org/pipermail/open-ils-documentation/attachments/20141003/c07c48bc/attachment-0003.png>