[docs] [issue36913] Missing documentation for decorators
report at bugs.python.org
Tue May 14 04:53:32 EDT 2019
Tomer Vromen <tomerv at gmail.com> added the comment:
Thank you for the quick response.
Are PEPs considered de-facto documentation for language features? For example, string formatting was described in PEP 3101, but still has sections in the documentation dedicated to it. I believe that decorators should get a similar treatment :-)
I also think that describing decorators as part of the grammar definition is lacking. Why is there a whole chapter for Errors and Exceptions and it's not only discussed under the grammar definition for raise?
Decorators are a pretty unique (and cool!) feature of Python, and therefore new learners of the language need a better reference for learning about them.
I realize that this is a big request, as you would need some expert to write this documentation.
Python tracker <report at bugs.python.org>
More information about the docs