Disconnected HTTPConnection and HTTPResponse docs
Hello. Found this email in documentation page. It is hard to find parameters for HTTPResponse, because texts describing its parameters are separated by differen documentaion block and are not linked together. https://docs.python.org/3/library/http.client.html#http.client.HTTPResponse https://docs.python.org/3/library/http.client.html#httpresponse-objects The same is true for HTTPConnection. https://docs.python.org/3/library/http.client.html#http.client.HTTPConnectio... https://docs.python.org/3/library/http.client.html#httpconnection-objects -- Anatoli Babenia +1 (650) 605-3365 +375 (29) 320-4241
Hi Anatoli, thanks for reporting, Looks like the 2nd word of https://docs.python.org/3/library/http.client.html#httpresponse-objects is a link to https://docs.python.org/3/library/http.client.html#http.client.HTTPResponse, isn't this enough? Or did I understand your message wrong? Bests, -- Julien Palard https://mdk.fr ‐‐‐‐‐‐‐ Original Message ‐‐‐‐‐‐‐ On Wednesday 19 December 2018 13:53, Anatoli Babenia <anatoli@rainforce.org> wrote:
Hello.
Found this email in documentation page.
It is hard to find parameters for HTTPResponse, because texts describing its parameters are separated by differen documentaion block and are not linked together. https://docs.python.org/3/library/http.client.html#http.client.HTTPResponse https://docs.python.org/3/library/http.client.html#httpresponse-objects
The same is true for HTTPConnection. https://docs.python.org/3/library/http.client.html#http.client.HTTPConnectio... https://docs.python.org/3/library/http.client.html#httpconnection-objects
-- Anatoli Babenia
+1 (650) 605-3365 +375 (29) 320-4241
Hello Julien. There is no backlink from class definitions to class explanations. The rest of the documentation links to class definitions making methods non-discoverable. On Wed, 26 Dec 2018 at 00:52, Julien Palard <julien@palard.fr> wrote:
Hi Anatoli, thanks for reporting,
Looks like the 2nd word of https://docs.python.org/3/library/http.client.html#httpresponse-objects is a link to https://docs.python.org/3/library/http.client.html#http.client.HTTPResponse, isn't this enough? Or did I understand your message wrong?
Bests, -- Julien Palard https://mdk.fr
‐‐‐‐‐‐‐ Original Message ‐‐‐‐‐‐‐ On Wednesday 19 December 2018 13:53, Anatoli Babenia < anatoli@rainforce.org> wrote:
Hello.
Found this email in documentation page.
It is hard to find parameters for HTTPResponse, because texts describing its parameters are separated by differen documentaion block and are not linked together. https://docs.python.org/3/library/http.client.html#http.client.HTTPResponse https://docs.python.org/3/library/http.client.html#httpresponse-objects
The same is true for HTTPConnection.
https://docs.python.org/3/library/http.client.html#http.client.HTTPConnectio... https://docs.python.org/3/library/http.client.html#httpconnection-objects
-- Anatoli Babenia
+1 (650) 605-3365 +375 (29) 320-4241
-- Anatoli Babenia +1 (650) 605-3365 +375 (29) 320-4241
participants (2)
-
Anatoli Babenia
-
Julien Palard