diff --git a/ansible/README.rst b/ansible/README.rst
index f18088ee1..f2f2a7f8c 100644
--- a/ansible/README.rst
+++ b/ansible/README.rst
@@ -205,6 +205,22 @@ dashboards
 
     # ansible-playbook -i hosts install/dashboards-openstack.yml
 
+Gather Metadata
+---------------
+
+Run the gather playbook to gather metadata about how the OpenStack cloud is
+currently configured. This playbook writes hardware(No. of CPUs etc),
+software(OpenStack Configuration), environment(No. of controllers etc) metadata
+files into the metadata directory which are transported to ElasticSearch along
+with test results to provide context for the result data. Make sure you do not
+run this playbook from a python virtual environment or it would fail.
+
+::
+
+    # ansible-playbook -i hosts gather/site.yml
+
+
+
 Performance Check
 -----------------