diff --git a/README.rst b/README.rst
index 6e5a0f981..5b009a7ea 100644
--- a/README.rst
+++ b/README.rst
@@ -25,9 +25,9 @@ Python API
 
 By way of a quick-start::
 
-    # use v2.0 auth with http://example.com:5000/v2.0/")
+    # use v2.0 auth with http://example.com:5000/v2.0")
     >>> from keystoneclient.v2_0 import client
-    >>> keystone = client.Client(USERNAME, API_KEY, PROJECT_ID)
+    >>> keystone = client.Client(username=USERNAME, password=API_KEY, project_id=TENANT, auth_url=KEYSTONE_URL)
     >>> keystone.tenants.list()
     >>> tenant = keystone.tenants.create(name="test", descrption="My new tenant!", enabled=True)
     >>> tenant.delete()
diff --git a/docs/index.rst b/docs/index.rst
index 87e5f5ebe..8dea24b33 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -11,10 +11,10 @@ using `keystone-manage`.
 Contents:
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
 
-   shell
    api
+   shell
    ref/index
    releases