readme updated

README.md

@@ -8,47 +8,40 @@ Requests: HTTP for Humans™
 [![image](https://img.shields.io/github/contributors/requests/requests.svg)](https://github.com/requests/requests/graphs/contributors)
 [![image](https://img.shields.io/badge/Say%20Thanks-!-1EAEDB.svg)](https://saythanks.io/to/kennethreitz)
 
-**If you're interested in financially supporting Kenneth Reitz open source, consider [visiting this link](https://cash.me/$KennethReitz). Your support helps tremendously with sustainability of motivation, as Open Source is no longer part of my day job.**
+**If you're interested in financially supporting Requests 3 development, please [make a donation](https://cash.me/$KennethReitz). Your support helps tremendously with sustainability of motivation.**
 
-Requests is the only *Non-GMO* HTTP library for Python, safe for human
-consumption.
+**Requests III** is an HTTP library for Python, built for Humans and Machines, alike. **This repository is a work in progress, and the expected release timeline is "before PyCon 2020".
 
 ![image](https://farm5.staticflickr.com/4317/35198386374_1939af3de6_k_d.jpg)
 
-Behold, the power of Requests:
+Behold, the power of Requests III:
 
 ``` {.sourceCode .python}
->>> r = requests.get('https://api.github.com/user', auth=('user', 'pass'))
->>> r.status_code
-200
->>> r.headers['content-type']
-'application/json; charset=utf8'
->>> r.encoding
-'utf-8'
->>> r.text
-u'{"type":"User"...'
->>> r.json()
-{u'disk_usage': 368627, u'private_gists': 484, ...}
-```
+>>> from requests import HTTPSession
 
-See [the similar code, sans Requests](https://gist.github.com/973705).
+# Make a connection pool.
+>>> http = HTTPSession()
+
+# Make a request.
+>>> r = http.request('get', 'https://httpbin.org/ip')
+>>> r.json()
+{'ip': '172.69.48.124'}
 
 [![image](https://raw.githubusercontent.com/requests/requests/master/docs/_static/requests-logo-small.png)](http://docs.python-requests.org/)
 
-Requests allows you to send *organic, grass-fed* HTTP/1.1 requests,
-without the need for manual labor. There's no need to manually add query
+Requests III allows you to send *organic, grass-fed* HTTP/1.1 & HTTP/2 requests,
+without the need for manual thought-labor. There's no need to add query
 strings to your URLs, or to form-encode your POST data. Keep-alive and
-HTTP connection pooling are 100% automatic, thanks to
-[urllib3](https://github.com/shazow/urllib3).
+HTTP connection pooling are 100% automatic, as well.
 
 Besides, all the cool kids are doing it. Requests is one of the most
-downloaded Python packages of all time, pulling in over 11,000,000
-downloads every month. You don't want to be left out!
+downloaded Python packages of all time, pulling in over ~1.6 million
+installations *per day*!
 
 Feature Support
 ---------------
 
-Requests is ready for today's web.
+Requests III is ready for today's web.
 
 -   International Domains and URLs
 -   Keep-Alive & Connection Pooling
@@ -76,7 +69,7 @@ To install Requests, simply use [pipenv](http://pipenv.org/) (or pip, of
 course):
 
 ``` {.sourceCode .bash}
-$ pipenv install requests
+$ pipenv install requests3
 ✨🍰✨
 ```
 
@@ -86,7 +79,7 @@ Documentation
 -------------
 
 Fantastic documentation is available at
-<http://docs.python-requests.org/>, for a limited time only.
+<http://3.python-requests.org/>, for a limited time only.
 
 How to Contribute
 -----------------
@@ -104,4 +97,3 @@ How to Contribute
 4.  Send a pull request and bug the maintainer until it gets merged and
     published. :) Make sure to add yourself to
     [AUTHORS](https://github.com/requests/requests/blob/master/AUTHORS.rst).
-