Message342435
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 how they work. The documentation should have a dedicated page for explaining decorators, and this should be the 1st search result.
--
In the meantime, then search should give as a 1st result a link to the definition of decorator in the glossary: https://docs.python.org/3.7/glossary.html#glossary
Actually, it seems that there is no way to directly link to a paragraph in the glossary - so that should be added as well.
In general, it would be nice if a search for some term X would show as a 1st result the definition of X in the glossary (if it exists there).
Thanks! |
|
Date |
User |
Action |
Args |
2019-05-14 07:35:28 | tomerv | set | recipients:
+ tomerv, docs@python |
2019-05-14 07:35:28 | tomerv | set | messageid: <1557819328.64.0.0474936169734.issue36913@roundup.psfhosted.org> |
2019-05-14 07:35:28 | tomerv | link | issue36913 messages |
2019-05-14 07:35:28 | tomerv | create | |
|