[docs] [issue36913] Missing documentation for decorators

Tomer Vromen 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 mailing list