features philosophy

diff --git a/docs/user/quickstart.rst b/docs/user/quickstart.rst
index 52f49d0..fea0766 100644 (file)
--- a/docs/user/quickstart.rst
+++ b/docs/user/quickstart.rst
@@ -1,6 +1,10 @@
 Feature Overview
 ================
 
+Requests is designed to solve a 90% use case — making simple requests. While most
+HTTP libraries are extremely extensible, they often attempt to support the entire HTTP Spec.
+This often leads to extremely messy and cumbersome APIs, as is the case with urllib2. Requests abandons support for edge-cases, and focuses on the essentials.
+
 
 .. _features:
 
@@ -12,10 +16,11 @@ Requests Can:
 - Add Request headers (with a simple dictionary)
 - URLEncode your Form Data (with a simple dictionary)
 - Add Multi-part File Uploads (with a simple dictionary)
-- Add CookieJars
-- Automatically decompress of GZipped responses
-- Support Unicode URLs
+- Handle CookieJars (with a single parameter)
+- Add HTTP Authentication (with a single parameter)
 - Handle redirects (with history)
+- Automatically decompress GZip'd responses
+- Support Unicode URLs
 - Gracefully timeout
 - Interface with Eventlet & Gevent