diff --git a/ansible/README.rst b/ansible/README.rst
index d451074ed..77833eb82 100644
--- a/ansible/README.rst
+++ b/ansible/README.rst
@@ -40,7 +40,7 @@ hosts file for ansible and generate a "jumpbox" ssh config:
 
     # ./generate_tripleo_hostfile.sh <undercloud-ip> ~/.ssh/config
 
-\*Review the hosts file the script generates.
+Review the hosts file the script generates.
 
 Ansible Installers
 ------------------
@@ -104,36 +104,57 @@ Install Generic ELK Clients
     ansible-playbook -i hosts install/elk-client.yml --extra-vars 'elk_server=X.X.X.X'
 
 -  elk\_server variable will be generated after the ELK stack playbook
-   runs #### Install ELK Clients for OpenStack nodes
+   runs
 
-   ::
+Install ELK Clients for OpenStack nodes
+'''''''''''''''''''''''''''''''''''''''
 
-       ansible-playbook -i hosts install/elk-openstack-client.yml --extra-vars 'elk_server=X.X.X.X'
+::
+
+    ansible-playbook -i hosts install/elk-openstack-client.yml --extra-vars 'elk_server=X.X.X.X'
 
 -  elk\_server variable will be generated after the ELK stack playbook
-   runs ##### Install graphite service
+   runs
 
-   ::
+Install graphite service
+''''''''''''''''''''''''
 
-       # ansible-playbook -i hosts install/graphite.yml
+When installing graphite, carbon-cache and grafana on a
+director/rdo-manager undecloud host, Use the docker playbook instead of
+this one.  This playbook is intended for use when you have enough
+resources to allocate dedicated systems for the graphing/stats related
+services.  Prior to installing grafana, please review
+install/group\_vars/all.yml file and your ansible inventory file You
+will need to define values for the grafana\_host and graphite\_host IP
+addresses here.
+
+::
+
+    # ansible-playbook -i hosts install/graphite.yml
 
 Install graphite service as a docker container
 ''''''''''''''''''''''''''''''''''''''''''''''
 
-   Prior to installing graphite as a docker container, please review
-   install/group\_vars/all.yml file and ensure the docker related
-   settings will work with your target host.
+Prior to installing graphite as a docker container, please review
+install/group\_vars/all.yml file and ensure the docker related settings
+will work with your target host. This playbook is ideal when installing
+services on director/rdo-manager undercloud host(s).
+   
+::
 
-   ::
-
-       # ansible-playbook -i hosts install/graphite-docker.yml
+    # ansible-playbook -i hosts install/graphite-docker.yml
 
 Install grafana service
 '''''''''''''''''''''''
 
-Prior to installing grafana, please review install/group\_vars/all.yml
-file and your ansible inventory file You will need to define values for
-the grafana\_host and graphite\_host IP addresses here.
+When installing graphite, carbon-cache and grafana on a
+director/rdo-manager undecloud host, Use the docker playbook instead of
+this one.  This playbook is intended for use when you have enough
+resources to allocate dedicated systems for the graphing/stats related
+services.  Prior to installing grafana, please review
+install/group\_vars/all.yml file and your ansible inventory file You
+will need to define values for the grafana\_host and graphite\_host IP
+addresses here.
 
 ::
 
@@ -144,7 +165,8 @@ Install grafana service as a docker container
 
 Prior to installing graphite as a docker container, please review
 install/group\_vars/all.yml file and ensure the docker related settings
-will work with your target host.
+will work with your target host. This playbook is ideal when installing
+services on director/rdo-manager undercloud host(s).
 
 ::