[issue36913] Missing documentation for decorators

2019-05-26 Thread Michael Blahay
Michael Blahay added the comment: The PEP is not the first place I go looking for information on Python topics, just my two cents. -- nosy: +mblahay ___ Python tracker ___

[issue36913] Missing documentation for decorators

2019-05-14 Thread Stéphane Wirtel
Change by Stéphane Wirtel : -- nosy: +mdk ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue36913] Missing documentation for decorators

2019-05-14 Thread Stéphane Wirtel
Stéphane Wirtel added the comment: Hi Tomer, >Thank you for the quick response. Welcome > >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

[issue36913] Missing documentation for decorators

2019-05-14 Thread Tomer Vromen
Tomer Vromen 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

[issue36913] Missing documentation for decorators

2019-05-14 Thread Stéphane Wirtel
Change by Stéphane Wirtel : -- versions: +Python 3.8 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue36913] Missing documentation for decorators

2019-05-14 Thread Stéphane Wirtel
Stéphane Wirtel added the comment: Hi, Thank you for your feedback. In fact, there is a limitation with the current search engine of Sphinx (because we use it for the documentation). For example, if you try to find the meaning of "for", for us it's a keyword but for the search engine, it

[issue36913] Missing documentation for decorators

2019-05-14 Thread Tomer Vromen
New submission from Tomer Vromen : The documentation for decorators (for methods and classes) is pretty lacking. Searching for "decorator" ( https://docs.python.org/3/search.html?q=decorator ) brings up a lot of libraries that use decorators, but no documentation explaining what they are and