diff --git a/README.rst b/README.rst
index b12945ba..de6de744 100644
--- a/README.rst
+++ b/README.rst
@@ -1,35 +1,9 @@
-OpenStack-Ansible Galera Server
-###############################
+===============================
+OpenStack-Ansible Galera server
+===============================
 
-Ansible role to install and configure a Galera cluster powered by MariaDB
-
-Default Variables
-=================
-
-.. literalinclude:: ../../defaults/main.yml
-   :language: yaml
-   :start-after: under the License.
-
-Required Variables
-==================
-
-To use this role, define the following variables:
-
-.. code-block:: yaml
-
-    galera_root_password: secrete
-
-
-Example Playbook
-================
-
-.. code-block:: yaml
-
-    - name: Install galera server
-      hosts: galera_all
-      user: root
-      roles:
-        - { role: "galera_server" }
-      vars:
-        galera_root_password: secrete
+Documentation for the project can be found at:
+  http://docs.openstack.org/developer/openstack-ansible-galera_server
 
+The project home is at:
+  http://launchpad.net/openstack-ansible
diff --git a/doc/source/index.rst b/doc/source/index.rst
index a6210d3d..b8b9352b 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -1 +1,28 @@
-.. include:: ../../README.rst
+===============================
+OpenStack-Ansible Galera server
+===============================
+
+Ansible role to install and configure a Galera cluster powered by MariaDB
+
+Default variables
+~~~~~~~~~~~~~~~~~
+
+.. literalinclude:: ../../defaults/main.yml
+   :language: yaml
+   :start-after: under the License.
+
+Required variables
+~~~~~~~~~~~~~~~~~~
+
+To use this role, define the following variables:
+
+.. code-block:: yaml
+
+    galera_root_password: secrete
+
+
+Example playbook
+~~~~~~~~~~~~~~~~
+
+.. literalinclude:: ../../examples/playbook.yml
+   :language: yaml
diff --git a/examples/playbook.yml b/examples/playbook.yml
new file mode 100644
index 00000000..b5c688b2
--- /dev/null
+++ b/examples/playbook.yml
@@ -0,0 +1,7 @@
+- name: Install Galera server
+  hosts: galera_all
+  user: root
+  roles:
+    - { role: "galera_server" }
+  vars:
+    galera_root_password: secrete