From 576e18a79686c84f908f7bdad7cfd56028404c1e Mon Sep 17 00:00:00 2001
From: Kenneth Reitz <me@kennethreitz.org>
Date: Fri, 17 Apr 2015 08:51:02 -0400
Subject: [PATCH] recommended packages and extensions

---
 docs/_templates/sidebarintro.html |  2 +-
 docs/community/recommended.rst    | 25 ++++++++++++++++++++++---
 2 files changed, 23 insertions(+), 4 deletions(-)

diff --git a/docs/_templates/sidebarintro.html b/docs/_templates/sidebarintro.html
index 11d32667..8e169c9c 100644
--- a/docs/_templates/sidebarintro.html
+++ b/docs/_templates/sidebarintro.html
@@ -41,7 +41,7 @@
 <h3>Useful Links</h3>
 <ul>
   <li><a href="http://certifi.io/en/latest/">Certifi: Best CA Bundle</a></li>
-  <li><a href="https://github.com/sigmavirus24/requests-toolbelt">Requests-Toolbelt</a></li>
+  <li><a href="http://docs.python-requests.org/en/latest/community/recommended/">Recomended Packages</a></li>
 
   <p></p>
 
diff --git a/docs/community/recommended.rst b/docs/community/recommended.rst
index cbd18c26..d2cd74f7 100644
--- a/docs/community/recommended.rst
+++ b/docs/community/recommended.rst
@@ -6,19 +6,38 @@ Recommended Packages
 Requests has a great variety of powerful and useful third-party extensions.
 This page provides an overview of some of the best of them.
 
+Certifi CA Bundle
+-----------------
+
+`Certifi`_ is a carefully curated collection of Root Certificates for
+validating the trustworthiness of SSL certificates while verifying the
+identity of TLS hosts. It has been extracted from the Requests project.
+
+.. _Certifi: http://certifi.io/en/latest/
+
 CacheControl
 ------------
 
-`CacheControl`_ is an extension that adds a full HTTP cache to requests. This
+`CacheControl`_ is an extension that adds a full HTTP cache to Requests. This
 makes your web requests substantially more efficient, and should be used
 whenever you're making a lot of web requests.
 
 .. _CacheControl: https://cachecontrol.readthedocs.org/en/latest/
 
-Requests-Oauthlib
+Requests-Toolbelt
 -----------------
 
-`requests-oauthlib`_ makes it possible to do the OAuth dance from requests
+`Requests-Toolbelt`_ is a collection of utilities that some users of Requests may desire,
+but do not belong in Requests proper. This library is actively maintained
+by members of the Requests core team, and reflects the functionality most
+requested by users within the community.
+
+.. _Requests-Toolbelt: http://toolbelt.readthedocs.org/en/latest/index.html
+
+Requests-OAuthlib
+-----------------
+
+`requests-oauthlib`_ makes it possible to do the OAuth dance from Requests
 automatically. This is useful for the large number of websites that use OAuth
 to provide authentication. It also provides a lot of tweaks that handle ways
 that specific OAuth providers differ from the standard specifications.