better index
authorKenneth Reitz <me@kennethreitz.com>
Sun, 15 May 2011 21:52:09 +0000 (17:52 -0400)
committerKenneth Reitz <me@kennethreitz.com>
Sun, 15 May 2011 21:52:09 +0000 (17:52 -0400)
docs/index.rst

index 9226dfb..dc8c321 100644 (file)
@@ -11,20 +11,12 @@ Release |version|.
 Requests is an :ref:`ISC Licensed <isc>` HTTP library, written in Python, for human beings.
 
 Most existing Python modules for sending HTTP requests are extremely verbose
-and cumbersome. Python's builtin :py:class:`urllib2` module provides all the
-HTTP capabilities required, but the api is thoroughly **broken**. It reqires an
-*enormous* amount of work (even method overrides) to perform the simplest of
-tasks.
+and cumbersome. Python's builtin :py:class:`urllib2` module provides most of
+the HTTP capabilities you should need, but the api is thoroughly **broken**.
+It reqires an *enormous* amount of work (even method overrides) to perform the simplest of tasks.
 
 Things shouldn’t be this way. Not in Python.
 
-Enter Requests. Requests allow you to send **GET**, **HEAD**, **PUT**,
-**POST**, and **DELETE** HTTP requests. You can add headers, form data,
-multipart files, and parameters with simple Python dictionaries, and access the
-response data in the same way. It's powered by :py:class:`urllib2`, but it does
-all the hard work and crazy hacks for you.
-
-
 It's Simple
 -----------
 
@@ -37,6 +29,11 @@ It's Simple
 
 See `the same code, without Requests <http://gist.github.com/some-gist>`_.
 
+Requests allow you to send **GET**, **HEAD**, **PUT**,
+**POST**, and **DELETE** HTTP requests. You can add headers, form data,
+multipart files, and parameters with simple Python dictionaries, and access the
+response data in the same way. It's powered by :py:class:`urllib2`, but it does
+all the hard work and crazy hacks for you.
 
 Testimonals
 -----------