[issue30787] Please add a comprehensive index of decorators to the documentation.

Brett Cannon added the comment: And thanks for at least bringing the idea forward, Tom. -- ___ Python tracker ___

[issue30787] Please add a comprehensive index of decorators to the documentation.

Brett Cannon added the comment: Both staticmethod and contextmanager are in the index under "S" and "C". But if you mean they were hard to discover, having them under a list of decorators wouldn't have necessarily helped since, as we pointed out, you may get misled to look for a decorator

[issue30787] Please add a comprehensive index of decorators to the documentation.

R. David Murray added the comment: Hmm. All the dunder methods are listed in the index on the '_' page. It would kind of be consistent to have an '@' page. Not sure what would be needed to make that happen though (might be a sphinx level thing). -- nosy: +r.david.murray

[issue30787] Please add a comprehensive index of decorators to the documentation.

tom kronmiller added the comment: I would not object if there was an index which contained the decorators among other things, but I have found it difficult in practice to discover things like @staticmethod and @contextmanager. Just as I browse the index of library modules to for insight as

[issue30787] Please add a comprehensive index of decorators to the documentation.

Raymond Hettinger added the comment: This request doesn't make sense to me. Decorators are an implementation technique and not really a topic unto themselves. FWIW, Guido recently rejected a request to create a listing of all the command line tools. Python docs are primarily organized by

[issue30787] Please add a comprehensive index of decorators to the documentation.

Brett Cannon added the comment: Why do you want an index of *just* decorators? The documentation is structured so you look for the module that probably contains a solution to your problem and then you see what the module may have (which may have a solution that isn't a decorator). Jumping

[issue30787] Please add a comprehensive index of decorators to the documentation.

New submission from tom kronmiller: It is difficult to learn what decorators there are because there is no single index which lists all of them (at least, I have been unable to find one). Instead, one must stumble across them while reading library module documentation. An index listing the