diff --git a/README.rst b/README.rst
index faf6b83..f4a4c3c 100644
--- a/README.rst
+++ b/README.rst
@@ -11,5 +11,11 @@ Team and repository tags
OpenStack-Ansible Repo Server
=============================
-Ansible role that deploys a repository server for python packages and git
-sources.
+Ansible role that deploys a repository server for python packages, git
+sources and package caching for deb/rpm.
+
+Documentation for the project can be found at:
+``_
+
+The project home is at:
+ http://launchpad.net/openstack-ansible
diff --git a/doc/source/index.rst b/doc/source/index.rst
index 3529983..d2bb5a9 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -2,8 +2,22 @@
OpenStack-Ansible Repo Server
=============================
-Example playbooks
+Ansible role that deploys a repository server for python packages, git
+sources and package caching for deb/rpm.
+
+To clone or view the source code for this repository, visit the role repository
+for `repo_server `_.
+
+Default variables
~~~~~~~~~~~~~~~~~
+.. literalinclude:: ../../defaults/main.yml
+ :language: yaml
+ :start-after: under the License.
+
+Required variables
+~~~~~~~~~~~~~~~~~~
+
+None.
Example playbook
~~~~~~~~~~~~~~~~