Tomer Vromen <tom...@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 <rep...@bugs.python.org>
<https://bugs.python.org/issue36913>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to