diff --git a/monitoring-for-openstack/README.rst b/monitoring-for-openstack/README.rst
index 7b98860..d626c7b 100644
--- a/monitoring-for-openstack/README.rst
+++ b/monitoring-for-openstack/README.rst
@@ -1,5 +1,25 @@
 ========================
-monitoring-for-openstack
+Monitoring for OpenStack
 ========================
 
-Set of Python scripts to help monitoring of OpenStack services.
+This is a set of Python scripts to help with the monitoring of
+OpenStack services.
+
+Installation
+============
+
+* Clone the osops-tools-monitoring repository::
+
+  git clone https://github.com/openstack/osops-tools-monitoring
+
+* Change to the ``monitoring-for-openstack`` directory::
+
+  cd osops-tools-monitoring/monitoring-for-openstack
+
+* Install the requirements::
+
+  pip install -r requirements.txt
+
+* Install the ``monitoring-for-openstack`` scripts::
+
+  python setup.py install
diff --git a/monitoring-for-openstack/setup.cfg b/monitoring-for-openstack/setup.cfg
index 4116cd6..a333aa8 100644
--- a/monitoring-for-openstack/setup.cfg
+++ b/monitoring-for-openstack/setup.cfg
@@ -2,7 +2,7 @@
 name = monitoring-for-openstack
 version = 1.0.1
 summary = OpenStack monitoring tools
-description-file = README.md
+description-file = README.rst
 author = OpenStack
 author-email = openstack-dev@lists.openstack.org
 classifier =