[issue37134] [EASY] Use PEP570 syntax in the documentation

Pablo Galindo Salgado report at bugs.python.org
Tue Jun 4 17:42:32 EDT 2019


Pablo Galindo Salgado <pablogsal at gmail.com> added the comment:

>  If that premise turns out to be false, we should think seriously about whether this makes the docs less approachable for everyday users.

We have not done such a thing for any other feature of the language. I think that since this is now a part of the language, it has all the right to be part of the documentation (possibly in some phased process). The contrary will be extremely unfair to the feature and to the PEP process: not a single other case had to fight separately to be included in the language and the documentation. 

And we even have an analogous case: keyword-only argument.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue37134>
_______________________________________


More information about the Python-bugs-list mailing list