←back to thread

320 points willm | 1 comments | | HN request time: 0.199s | source
Show context
mjd ◴[] No.45106669[source]
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.

replies(3): >>45106735 #>>45109623 #>>45116352 #
1. shim__ ◴[] No.45116352[source]
Bad documentation is customary when writing Python