[mypyc] feat(docs): detail issue with inspect.iscoroutinefunction

[BobTheBuidler]

Silly little PR, but this note could have saved me some debugging time.

I also opened an issue and will make an attempt to solve the problem sometime in Q3.