[issue37862] Search doesn't find built-in functions

2019-08-21 Thread Kim Oldfield


Kim Oldfield  added the comment:

Usually the search page is the quickest way to find documentation about a 
module or function - quicker than navigating through a couple of levels of 
pages (documentation home, index, index by letter, scroll or search in page to 
find desired name, click on name).

Searching for builtin functions is inconsistent. Some functions (eg getattr) 
are found as expected in a search, while other functions (eg zip and many 
others) aren't found in the search results. This could easily lead someone to 
incorrectly concluding that the function they are search for doesn't exist in 
python.

I find the response of "The search page is the last thing one should use" 
strange. Surely as the option to search is there, and it mostly works, we 
should be making incremental improvements as necessary to make it better so 
that everyone can easily find the right parts of the python documentation.

--

___
Python tracker 
<https://bugs.python.org/issue37862>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue37862] Search doesn't find built-in functions

2019-08-14 Thread Kim Oldfield


New submission from Kim Oldfield :

The python 3 documentation search
https://docs.python.org/3/search.html
doesn't always find built-in functions.

For example, searching for "zip" takes me to
https://docs.python.org/3/search.html?q=zip

I would expect the first match to be a link to
https://docs.python.org/3/library/functions.html#zip
but I can't see a link to this page anywhere in the 146 results.

--
assignee: docs@python
components: Documentation
messages: 349781
nosy: docs@python, kim.oldfield
priority: normal
severity: normal
status: open
title: Search doesn't find built-in functions
type: behavior
versions: Python 2.7, Python 3.5, Python 3.6, Python 3.7, Python 3.8, Python 3.9

___
Python tracker 
<https://bugs.python.org/issue37862>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com