Reading the complete content of an HTTP GET request

Yes, sounds like a good plan.

However if you look at the docs for http.get there's a code example right there. There are also a bunch of examples linked that do the right thing, there's also the 'Internet' page, ESP8266 page, and pretty much any tutorial that does an HTTP GET.

It's presumably just if you look at the Reference page itself for HttpCRs (in isolation) while ignoring the code under http.get that you get the wrong impression? Perhaps the docs for HttpCRs could just link back to get and request?