-
-
Notifications
You must be signed in to change notification settings - Fork 32.4k
Open
Labels
docsDocumentation in the Doc dirDocumentation in the Doc dir
Description
Documentation
Caution
For new contributors, please do not consider this issue as an "easy" one. While the changes may seem mechanical, they are not necessarily trivial as this requires to know what really happens (both at a Python and a C level).
This is tracks cases where changes need to be made to enact the Editorial Board's decision for function signature markup.
- builtins:
min()
max()
range()
map()
To pick up a draggable item, press the space bar. While dragging, use the arrow keys to move the item. Press space again to drop the item in its new position, or press escape to cancel.
- methods on builtins:
dict.get()
,dict.setdefault()
To pick up a draggable item, press the space bar. While dragging, use the arrow keys to move the item. Press space again to drop the item in its new position, or press escape to cancel.
See also:
- https://discuss.python.org/t/editorial-board-decisions/58580
- gh-129667: Update annotation in documentation #129669 (comment)
- https://discuss.python.org/t/81003
- https://devguide.python.org/documentation/style-guide/#function-signatures
- https://discuss.python.org/t/58750
Linked PRs
- gh-131885: Updates docs to make max and min iterable param positional only #131868
- gh-131885: simplify function signatures in the cmath module #131886
- gh-131885: Document that dict.setdefault takes no keyword arguments #128208
- [3.13] gh-131885: Document that
dict.setdefault
anddict.get
take no keyword arguments (GH-128208) #131893 - [3.12] gh-131885: Document that
dict.setdefault
anddict.get
take no keyword arguments (GH-128208) #131894 - gh-131885: Document
/
fordecimal.Context
methods #131990 - gh-131885: Document
/
forcodecs
functions #131992 - gh-131885: Document
*
forcode.InteractiveConsole
#132029 - gh-131885: update documented signatures for
csv.{writer,reader}
#136085 - [3.14] gh-131885: Update documented signatures for
csv.{writer,reader}
(GH-136085) #136120 - [3.13] gh-131885: Update documented signatures for
csv.{writer,reader}
(GH-136085) #136121
Metadata
Metadata
Assignees
Labels
docsDocumentation in the Doc dirDocumentation in the Doc dir
Projects
Status
Todo
Milestone
Relationships
Development
Select code repository
Activity
pythongh-131885: simplify function signatures in the cmath module
gh-131885: Document that `dict.setdefault` and `dict.get` take no key…
pythongh-131885: Document that `dict.setdefault` and `dict.get` take …
pythongh-131885: Document that `dict.setdefault` and `dict.get` take …
dict.setdefault
anddict.get
take no keyword arguments (GH-128208) #131893dict.setdefault
anddict.get
take no keyword arguments (GH-128208) #131894[3.13] gh-131885: Document that `dict.setdefault` and `dict.get` take…
[3.12] gh-131885: Document that `dict.setdefault` and `dict.get` take…
chris-eibl commentedon Mar 30, 2025
Regarding
range
, please see also #125897.23 remaining items