summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorJon Wayne Parrott <jon.wayne.parrott@gmail.com>2016-06-10 11:06:19 -0700
committerJon Wayne Parrott <jon.wayne.parrott@gmail.com>2016-06-28 09:49:47 -0700
commit78aabb2ae24dc8dd318d3391ba7102d296293edc (patch)
treef9fcb6aabce977b5bdeac7612bd6a687185e2fa6 /docs
parent4a15a6bc081661af0b2160a9ea98d4c5846ab768 (diff)
downloadurllib3-78aabb2ae24dc8dd318d3391ba7102d296293edc.tar.gz
Updating copy on landing page.
Diffstat (limited to 'docs')
-rw-r--r--docs/index.rst17
1 files changed, 12 insertions, 5 deletions
diff --git a/docs/index.rst b/docs/index.rst
index 48bcdce6..afafb75d 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -10,10 +10,9 @@ urllib3
reference/index
contributing
-Urllib3 is a *sanity-friendly* HTTP client for Python. It helps you avoid the
-inevitable heartache and frustration of lower-level HTTP clients. It is the
-magic beneath the fantastic `Requests <http://python-requests.org/>`_ library.
-Notable features include:
+Urllib3 is a powerful, *sanity-friendly* HTTP client for Python. Much of the
+Python ecosystem :ref:`already uses <who-uses>` urllib3 and you should too. Urllib3 brings
+many critical features that are missing from the Python standard libraries:
- Thread safe.
- Connection pooling.
@@ -24,7 +23,7 @@ Notable features include:
- Proxy support for HTTP and SOCKS.
- 100% test coverage.
-Urllib3 is both easy to use and powerful::
+Urllib3 is powerful and easy to use::
>>> import urllib3
>>> http = urllib3.PoolManager()
@@ -54,6 +53,14 @@ accomplish common tasks. The more in-depth :doc:`advanced-usage` guide is the pl
The :doc:`reference/index` documentation provides API-level documentation.
+.. _who-uses:
+
+Who uses urllib3?
+-----------------
+
+* `Requests <http://python-requests.org/>`_
+* `Pip <https://pip.pypa.io>`_
+* TODO: MOAR
License
-------