I have seen many people new to Python stumbling while using the Python
docs due to the order of the search results.
For example, if somebody new to python searches for `tuple`, the
actual section about `tuple` comes in place 39. What is more confusing
for people starting with the language is that all the C functions come
first. I have seen people clicking in PyTupleObject just to be totally
Maybe `tuple` is a silly example. But if somebody wants to know how
does `open` behaves and which arguments it takes, the result comes in
position 16. `property` does not appear in the list at all (but
built-in appears in position 31). This is true for most builtins.
Experienced people will have no trouble navigating through these
results, but new users do. It is not terrible and at the end they get
it, but I think it would be nice to change it to more (new) user
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)
I have just had to mute two threads where people were trying to convince
each other that a certain language feature is/isn't a wart. This form of
educational debate belongs in python-list, not here, please.
--Guido van Rossum (sent from Android phone)
I am thinking about [python-wart] on SO. There is no currently a list of
Python warts, and building a better language is impossible without a clear
visibility of warts in current implementations.
Why Roundup doesn't work ATM.
- warts are lost among other "won't fix" and "works for me" issues
- no way to edit description to make it more clear
- no voting/stars to percieve how important is this issue
- no comment/noise filtering
and the most valuable
- there is no query to list warts sorted by popularity to explore other
time-consuming areas of Python you are not aware of, but which can popup
SO at least allows:
+ community wiki edits
+ useful comment upvoting
+ sorted lists
+ user editable tags (adding new warts is easy)
This post is a result of facing with numerous locals/settrace/exec issues
that are closed on tracker. I also have my own list of other issues
(logging/subprocess) at GC project, which I might be unable to maintain in
future. There is also some undocumented stuff (subprocess deadlocks) that
I'm investigating, but don't have time for a write-up. So I'd rather move
this somewhere where it could be updated.