Merge pull request #2550 from Lukasa/recommended

Recommended packages.

docs/community/recommended.rst

@@ -0,0 +1,26 @@
+.. _recommended:
+
+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.
+
+CacheControl
+------------
+
+`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-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.
+
+.. _requests-oauthlib: https://requests-oauthlib.readthedocs.org/en/latest/

docs/index.rst

@@ -114,6 +114,7 @@ Requests ecosystem and community.
    :maxdepth: 1
 
    community/faq
+   community/recommended
    community/out-there.rst
    community/support
    community/vulnerabilities