[3.12] gh-123523: Rework typing documentation for generators and coro…

[3.12] gh-123523: Rework typing documentation for generators and coro… #1118