TypeVars in documentation

[cjtapper]

Package Version

1.12.2

Description

Is there a better way to annotate these types so that the docs are more informative? I'm relatively new to typing and am unsure of what the best way to do this is. Should we just rename _R to something like _HttpResponse?

[adamchainz]

Good spot. I know people are disussing ways of improving sphinx's output here, but for now it's pragmatic to use a more explicit typevar name. It will help in text editors that use the hints as well. #266 changes the name.