Request for review: "http.client" documentation update

Is there a reviewer with expertise in the http.client documentation that is available to review the revision proposed by this issue and it’s associated PR?

Specifically, I’m proposing to include more clarifying information about the url parameter, because it is easy to provide a value that violates the RFC 2616 §5.1.2 standard, which some HTTP servers will choke on.

P.S. I am posting this ping >1 month after no activity, as recommended by the dev guide.