▲ | mjd 2 days ago | ||||||||||||||||||||||
I haven't read the article yet, but I do have something to contribute: several years ago I was ay PyCon and saw a talk in which someone mentioned async. I was interested and wanted to learn to use it. But I found there was no documentation at all! The syntax was briefly described, but not the semantics. I realized, years later, that the (non-)documentation was directed at people who were already familiar with the feature from Javascript. But I hadn't been familiar with it from Javascript and I didn't even know that Javascript had had such a feature. So that's my tiny contribution to this discussion, one data point: Python's async might have been one unit more popular if it had had any documentation, or even a crossreference to the Javascript documentation. | |||||||||||||||||||||||
▲ | notatoad 2 days ago | parent | next [-] | ||||||||||||||||||||||
this was my initial experience with python async as well (which i now use heavily) the documentation is directed at people who want coroutines and futures, and know what that means. if you don't know what coroutines and futures are, the python docs aren't going to help you. the documentation isn't going to guide anybody into using the async features who aren't already seeking them out. and maybe that's intentional, but it's not going to grow adoption of the async features. | |||||||||||||||||||||||
▲ | shim__ 2 days ago | parent | prev | next [-] | ||||||||||||||||||||||
Bad documentation is customary when writing Python | |||||||||||||||||||||||
▲ | int_19h 2 days ago | parent | prev [-] | ||||||||||||||||||||||
FWIW Python got async/await before JavaScript did. I believe at the time the main inspiration was C#. | |||||||||||||||||||||||
|