Feature request: make searching for "@" return information on decorators
TL;DR: see the subject line I'm new to Python and was reading code that used this: @property def ... and I didn't know what it meant. I looked in the python.org docs for "@" and "@property" and didn't get any results, so I turned to Google and found a good page on stackoverflow about how "@property" worked ( http://stackoverflow.com/questions/17330160/python-how-does-the-property-dec... ). However, I still did not understand "@". I eventually asked a colleague (I try to RTFM before asking), and he said "oh ya, that's a decorator." Once I knew that "@" = "decorator," I could search for "decorator" in the docs and get useful results. In fact, I found a LOT of great results; this isn't a request for more information on decorators :). I probably spent 15-20 minutes before learning @ = decorator, and I'm sure this is something that plagues other newbies. Can the docs (or search functionality) be updated so someone searching on "@" as a single search term will get information on decorators? Search results could include a direction to the decorator entry in the glossary?, the function/class definition pages, etc. Thanks, Will
participants (1)
-
Will Marler