recommend requests library (closes #23989)
Patch by Van Lindberg.
diff --git a/Doc/library/httplib.rst b/Doc/library/httplib.rst
index a4bff4f..03f4fb2 100644
--- a/Doc/library/httplib.rst
+++ b/Doc/library/httplib.rst
@@ -24,6 +24,11 @@
HTTPS protocols. It is normally not used directly --- the module :mod:`urllib`
uses it to handle URLs that use HTTP and HTTPS.
+.. seealso::
+
+ The `Requests package <http://requests.readthedocs.org/>`_
+ is recommended for a higher-level http client interface.
+
.. note::
HTTPS support is only available if the :mod:`socket` module was compiled with
diff --git a/Doc/library/urllib.rst b/Doc/library/urllib.rst
index b2a817d..d0cc548 100644
--- a/Doc/library/urllib.rst
+++ b/Doc/library/urllib.rst
@@ -24,6 +24,11 @@
instead of filenames. Some restrictions apply --- it can only open URLs for
reading, and no seek operations are available.
+.. seealso::
+
+ The `Requests package <http://requests.readthedocs.org/>`_
+ is recommended for a higher-level http client interface.
+
.. warning:: When opening HTTPS URLs, it does not attempt to validate the
server certificate. Use at your own risk!
diff --git a/Doc/library/urllib2.rst b/Doc/library/urllib2.rst
index f599894..3fe4f25 100644
--- a/Doc/library/urllib2.rst
+++ b/Doc/library/urllib2.rst
@@ -18,6 +18,11 @@
URLs (mostly HTTP) in a complex world --- basic and digest authentication,
redirections, cookies and more.
+.. seealso::
+
+ The `Requests package <http://requests.readthedocs.org/>`_
+ is recommended for a higher-level http client interface.
+
The :mod:`urllib2` module defines the following functions: