diff --git a/README.rst b/README.rst
index bdf727d7..08c48adb 100644
--- a/README.rst
+++ b/README.rst
@@ -1,81 +1,8 @@
-OpenStack-Ansible Plugins
+=========================
+OpenStack-Ansible plugins
 =========================
 
 These are the plugins the OpenStack-Ansible deployment project relies on. The
 plugins can be added to any Ansible project by simply cloning this repository
 and setting up the ``ansible.cfg`` file to point at them as additional plugins
 for your project.
-
-Actions
--------
-
-This project provides the Ansible modules:
-
- * config_template
- * dist_sort
- * glance
- * keystone
- * memcached
- * name2int
- * neutron
- * provider_networks
-
-Filters
--------
-
-This project provides the Ansible Jinja2 filters:
-
- * bit_length_power_of_2
- * netloc
- * netloc_no_port
- * netorigin
- * string_2_int
- * pip_requirement_names
- * pip_constraint_update
- * splitlines
- * filtered_list
- * git_link_parse
- * git_link_parse_name
- * deprecated
-
-Lookups
--------
-
-This project provides the lookup:
-
- * with_py_pkgs
-
-Callbacks
----------
-
-This project provides an Ansible callback that will report
-task profiling timings
-
-
-Example ansible.cfg file
-------------------------
-
-.. code-block:: ini
-
-    [defaults]
-    lookup_plugins = /etc/ansible/plugins/lookups
-    filter_plugins = /etc/ansible/plugins/filters
-    action_plugins = /etc/ansible/plugins/actions
-    library = /etc/ansible/plugins/library
-
-
-Example role requirement overload for automatic plugin download
----------------------------------------------------------------
-
-The Ansible role requirement file can be used to overload the ``ansible-
-galaxy`` command to automatically fetch the plugins for you in a given
-project. To do this add the following lines to your ``ansible-role-
-requirements.yml`` file.
-
-.. code-block:: yaml
-
-    - name: plugins
-      src: https://github.com/openstack/openstack-ansible-plugins
-      path: /etc/ansible
-      scm: git
-      version: master
diff --git a/doc/source/index.rst b/doc/source/index.rst
index 38ba8043..b2ce349d 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -1 +1,69 @@
-.. include:: ../../README.rst
\ No newline at end of file
+=========================
+OpenStack-Ansible plugins
+=========================
+
+Actions
+~~~~~~~
+
+This project provides the Ansible modules:
+
+ * config_template
+ * dist_sort
+ * glance
+ * keystone
+ * memcached
+ * name2int
+ * neutron
+ * provider_networks
+
+Filters
+~~~~~~~
+
+This project provides the Ansible Jinja2 filters:
+
+ * bit_length_power_of_2
+ * netloc
+ * netloc_no_port
+ * netorigin
+ * string_2_int
+ * pip_requirement_names
+ * pip_constraint_update
+ * splitlines
+ * filtered_list
+ * git_link_parse
+ * git_link_parse_name
+ * deprecated
+
+Lookups
+~~~~~~~
+
+This project provides the lookup:
+
+ * with_py_pkgs
+
+Callbacks
+~~~~~~~~~
+
+This project provides an Ansible callback that will report
+task profiling timings
+
+
+Example ``ansible.cfg`` file
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. literalinclude:: ../../examples/example.ini
+   :language: yaml
+
+
+Example role requirement overload for automatic plugin download
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The Ansible role requirement file can be used to overload the ``ansible-
+galaxy`` command to automatically fetch the plugins for you in a given
+project. To do this add the following lines to your ``ansible-role-
+requirements.yml`` file.
+
+.. literalinclude:: ../../examples/playbook.yml
+   :language: yaml
+
+
diff --git a/examples/example.ini b/examples/example.ini
new file mode 100644
index 00000000..37115855
--- /dev/null
+++ b/examples/example.ini
@@ -0,0 +1,5 @@
+[defaults]
+lookup_plugins = /etc/ansible/plugins/lookups
+filter_plugins = /etc/ansible/plugins/filters
+action_plugins = /etc/ansible/plugins/actions
+library = /etc/ansible/plugins/library
diff --git a/examples/playbook.yml b/examples/playbook.yml
new file mode 100644
index 00000000..7709b420
--- /dev/null
+++ b/examples/playbook.yml
@@ -0,0 +1,4 @@
+- name: plugins
+  src: https://github.com/openstack/openstack-ansible-plugins
+  scm: git
+  version: master