Extend the KDoc for some channel APIs

[globsterg]

trafficstars

One of the pieces of https://github.com/Kotlin/kotlinx.coroutines/issues/4133.

Each file can be reviewed independently (and changes to other files will be added later). I'm keeping this a single pull request to avoid spamming.