[issue45378] Can't find "map" with search on docs.python.org

[Terry J. Reedy]

Terry J. Reedy  added the comment:

The iterator classes are not identified as such because being a class instead 
of a function, such as a generator function, is a CPython implementation 
detail, not a language requirement.

Searching for filter seems as bad -- builtin filter is about the 60th hit.  
Builtins should be listed first instead.

--
nosy: +terry.reedy

___
Python tracker 

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

[issue45378] Can't find "map" with search on docs.python.org

[Guido van Rossum]

Guido van Rossum  added the comment:

> I'm surprised no one else noticed this until now.  

Most people probably just use Google and read whatever comes up. I was looking 
whether the official docs for map mentioned that map is actually an iterator 
class. (They don't.)

--

___
Python tracker 

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

[issue45378] Can't find "map" with search on docs.python.org

[Raymond Hettinger]

Raymond Hettinger  added the comment:

I'm surprised no one else noticed this until now.  

The doc search finds some entries such as: "sum", "min", "max", and 
"enumerate".  However, it is missing others such as: "map" and "filter".

--
nosy: +rhettinger

___
Python tracker 

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

[issue45378] Can't find "map" with search on docs.python.org

[Raúl Cumplido]

Change by Raúl Cumplido :


--
nosy: +raulcd

___
Python tracker 

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

[issue45378] Can't find "map" with search on docs.python.org

[Guido van Rossum]

New submission from Guido van Rossum :

I was looking for the docs for 'map' and tried to use the search box on 
docs.python.org. This gave a lot of things whose name started with or contained 
'map', but the entry for the builtin map() function was hidden really far down 
under the heading "Builtin Functions" 
(https://docs.python.org/3.10/library/functions.html?highlight=map) rather than 
deep-linking to the entry I was looking for 
(https://docs.python.org/3.10/library/functions.html#map).

I'm sure that some tweak to the index builder could fix this, in general, for 
all builtin functions and types (many of which I imagine suffer from the effect 
-- having a short name that is used a lot as a part of other names).

--
assignee: docs@python
components: Documentation
messages: 403245
nosy: docs@python, gvanrossum
priority: normal
severity: normal
status: open
title: Can't find "map" with search on docs.python.org
type: behavior

___
Python tracker 

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