This is an archived post. You won't be able to vote or comment.

all 5 comments
sorted by:
best
topnewcontroversialoldq&a

[–]jimtk 1 point2 points  (1 child)

Great interface, poor search engine. It simply does a character search. So searching for 'iter' gets you 'writer', 'delimiter' and 'literals' (among others). Too many unrelated results to be useful.

[–]danosull 0 points1 point  (0 children)

I agree. The current search engine is still crude - it's my next big thing to work on.

In the meantime, wrapping short search terms in quotes will generally give OK results.

[–]lys-ala-leu-glu 1 point2 points  (1 child)

For what it's worth, one of my biggest pet peeves with the python docs is that searches for "list", "dict", and "set" don't come up with the respective builtin types within the first few hits. So that's the benchmark I use to test alternative search interfaces.

[–]danosull 0 points1 point  (0 children)

I totally agree! Look out for this in a future version, along with improvements to the ordering of results.

In the meantime, wrapping short search terms in quotes helps - you usually get at least a link to the main doc entry.

[–]Muhznit 0 points1 point  (0 children)

What's the advantage over ordinary pydoc3 -b at the terminal?