This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author tomerv
Recipients docs@python, matrixise, tomerv
Date 2019-05-14.08:53:32
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <>
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.
Date User Action Args
2019-05-14 08:53:32tomervsetrecipients: + tomerv, docs@python, matrixise
2019-05-14 08:53:32tomervsetmessageid: <>
2019-05-14 08:53:32tomervlinkissue36913 messages
2019-05-14 08:53:32tomervcreate