[DOCS] Move playbook example to separate file

Change-Id: Ie37cbb4917307743ab97f001c1d1d092b3b0051b

README.rst

@@ -1,32 +1,9 @@
+=================================
 OpenStack-Ansible openstack_hosts
-#################################
-
-Role for basic setup and configuration of a host machine for the intended
-purpose of use within OpenStack. This role was created to tune a host to
-receive OpenStack. The basic operations within the role allow it to install,
-setup, and tune specific kernel options that all OpenStack powered hosts will
-need to perform nominally.
-
-Default Variables
-=================
-
-.. literalinclude:: ../../defaults/main.yml
-   :language: yaml
-   :start-after: under the License.
-
-Required Variables
-==================
-
-None
-
-Example Playbook
-================
-
-.. code-block:: yaml
-
-    - name: Basic host setup
-      hosts: "hosts"
-      user: root
-      roles:
-        - { role: "openstack_hosts" }
+=================================
 
+Role for basic setup and configuration of a host machine for use
+within OpenStack. This role tunes a host to receive OpenStack. The
+basic operations within the role allow it to install, setup, and tune
+specific kernel options that all OpenStack-powered hosts need to
+perform nominally.

doc/source/index.rst

@@ -1 +1,21 @@
-.. include:: ../../README.rst
+=================================
+OpenStack-Ansible openstack_hosts
+=================================
+
+Default variables
+~~~~~~~~~~~~~~~~~
+
+.. literalinclude:: ../../defaults/main.yml
+   :language: yaml
+   :start-after: under the License.
+
+Required variables
+~~~~~~~~~~~~~~~~~~
+
+None
+
+Example playbook
+~~~~~~~~~~~~~~~~
+
+.. literalinclude:: ../../examples/playbook.yml
+   :language: yaml

examples/playbook.yml

@@ -0,0 +1,5 @@
+- name: Basic host setup
+  hosts: "hosts"
+  user: root
+  roles:
+    - { role: "openstack_hosts" }