<div><br><div class="gmail_quote">2012/12/30 Hernan Grecco <span dir="ltr"><<a href="mailto:hernan.grecco@gmail.com" target="_blank">hernan.grecco@gmail.com</a>></span><br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Hi,<br>
<br>
I have seen many people new to Python stumbling while using the Python<br>
docs due to the order of the search results.<br>
<br>
For example, if somebody new to python searches for  `tuple`, the<br>
actual section about `tuple` comes in place 39. What is more confusing<br>
for people starting with the language is that all the C functions come<br>
first. I have seen people clicking in PyTupleObject just to be totally<br>
disoriented.<br>
<br>
Maybe `tuple` is a silly example. But if somebody wants to know how<br>
does `open` behaves and which arguments it takes, the result comes in<br>
position 16. `property` does not appear in the list at all (but<br>
built-in appears in position 31). This is true for most builtins.<br>
<br>
Experienced people will have no trouble navigating through these<br>
results, but new users do. It is not terrible and at the end they get<br>
it, but I think it would be nice to change it to more (new) user<br>
friendly order.<br>
<br>
So my suggestion is to put the builtins first, the rest of the<br>
standard lib later including HowTos, FAQ, etc and finally the<br>
c-modules. Additionally, a section with a title matching exactly the<br>
search query should come first. (I am not sure if the last suggestion<br>
belongs in python-ideas or in<br>
the sphinx mailing list, please advice)<br>
<br>
Thanks,<br>
<br>
Hernan<br>
_______________________________________________<br>
Python-ideas mailing list<br>
<a href="mailto:Python-ideas@python.org">Python-ideas@python.org</a><br>
<a href="http://mail.python.org/mailman/listinfo/python-ideas" target="_blank">http://mail.python.org/mailman/listinfo/python-ideas</a><br>
</blockquote></div><br></div><div>+1<div>I agree it's sub-optimal.</div></div>