Improve async documentation (#14973)
Some of the examples here neither ran nor type checked. Remove mention
and use of deprecated APIs.
Also go into some detail about async generators. Document #5385 since it
comes up not infrequently.
Linking #13681
