Hi, Thanks for all the feedback. I was hacking the sphinx indexer and the javacript searchtool today. I think the search results can be improved by patching sphinx upstream and adding a small project dependent (in this case Python) javascript snippet. I have created a proposal in the Sphinx Issue tracker [0]. Let's move the discussion there. best, Hernan [0] https://bitbucket.org/birkenfeld/sphinx/issue/1067/better-search-results On Mon, Dec 31, 2012 at 8:47 AM, Stefan Drees <stefan@drees.name> wrote:
On 30.12.12 20:45, Georg Brandl wrote:
On 12/30/2012 07:11 PM, Ned Batchelder wrote:
On 12/30/2012 12:54 PM, Hernan Grecco wrote:
...
I have seen many people new to Python stumbling while using the Python docs due to the order of the search results. ...
So my suggestion is to put the builtins first, the rest of the standard lib later including HowTos, FAQ, etc and finally the c-modules. Additionally, a section with a title matching exactly the search query should come first. (I am not sure if the last suggestion belongs in python-ideas or in the sphinx mailing list, please advice)
While we're on the topic, why in this day and age do we have a custom search? Using google site search would be faster for the user, and more accurate.
I agree. Someone needs to propose a patch though. ...
a custom search in itself is a wonderful thing. To me it also shows more appreciation of visitor concerns than thoses sites, that are just _offering_ google site search (which is accessible anyway to every visitor capable of memorizing the google or bing or whatnot URL).
I second Hernans suggestion about ordering and also his question where the request (and patches) should be directed to.
All the best, Stefan.
_______________________________________________ Python-ideas mailing list Python-ideas@python.org http://mail.python.org/mailman/listinfo/python-ideas