Florian Dahlitz added the comment:
I guess it would have been good if I waited submitting a PR until you replied to my message. This way, I would have known that two separate PRs would be better suited here - sorry for that.
Nevertheless, I read the discussions here and in PR #995 and I'm pretty sure that the proposed changes do fit into the documentation (pretty similar to those from PR #995).
I'm eager to hear your or other people's feedback - thanks!
----------
_______________________________________
Python tracker
https://bugs.python.org/issue29981
_______________________________________