[Python-ideas] Order in the documentation search results

[Hernan Grecco]

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 at 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 at python.org
> http://mail.python.org/mailman/listinfo/python-ideas