Add session documentation to API documentation file
@@ -106,3 +106,16 @@ Using JQ to query out a specific attribute
.. code-block:: bash
$ geocode "453 Booth Street" -p canadapost --output json | jq .postal
+
+Using a Session
+---------------
+
+In case you have several addresses to encode, to use persistent HTTP connection as recommended by the request-library
+http://docs.python-requests.org/en/master/user/advanced/#session-objects
+you might use the following:
+
+
+.. code-block:: python
+ >>> with requests.Session() as session:
+ >>> berlin = geocoder.google("Ritterstr. 12, 10969 Berlin", session=session)
+ >>> ottawa = geocoder.google("453 Booth Street, Ottawa ON", session=session)
