api update

diff --git a/docs/api.rst b/docs/api.rst
index cabc0e7..9d9bc0a 100644 (file)
--- a/docs/api.rst
+++ b/docs/api.rst
@@ -13,12 +13,18 @@ important right here and provide links to the canonical documentation.
 Main Interface
 --------------
 
+All of Request's functionality can be accessed by these 5 methods. They
+all return a :class:`Response <models.Response>` object.
+
 .. autofunction:: get
 .. autofunction:: post
 .. autofunction:: put
 .. autofunction:: delete
 .. autofunction:: head
 
+-----------
+
+
 .. autoclass:: requests.models.Response
    :inherited-members: