diff --git a/README.rst b/README.rst
index 15832df..19aeabe 100644
--- a/README.rst
+++ b/README.rst
@@ -1,9 +1,8 @@
 OpenStack Aodh
 ##############
-:tags: openstack, ceilometer, cloud, ansible, aodh
-:category: \*nix
 
-Role to install aodh as the alarm functionality of Telemetry
+Ansible role that installs and configures OpenStack Aodh as the alarm
+functionality of Telemetry.
 
 This role will install the following:
     * aodh-api
@@ -11,6 +10,19 @@ This role will install the following:
     * aodh-evaluator
     * aodh-notifier
 
+The role will configure Aodh to use MongoDB for data storage, but does
+not install or configure MongoDB.
+
+Default Variables
+=================
+
+.. literalinclude:: ../../defaults/main.yml
+   :language: yaml
+   :start-after: under the License.
+
+Example Playbook
+================
+
 .. code-block:: yaml
 
     - name: Install aodh services
@@ -21,4 +33,3 @@ This role will install the following:
       vars:
         external_lb_vip_address: 172.16.24.1
         internal_lb_vip_address: 192.168.0.1
-        galera_address: "{{ internal_lb_vip_address }}"
diff --git a/doc/source/index.rst b/doc/source/index.rst
index e515e35..38ba804 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -1,12 +1 @@
-os_aodh Docs
-============
-
-Role to install aodh as the alarm functionality of Telemetry
-
-Basic Role Example
-^^^^^^^^^^^^^^^^^^
-
-.. code-block:: yaml
-
-    - role: "os_aodh"
-      ROLE_VARS...
+.. include:: ../../README.rst
\ No newline at end of file