diff --git a/contrib/templates/example/README.rst b/contrib/templates/example/README.rst
index dfcc578613..b20dd67f3f 100644
--- a/contrib/templates/example/README.rst
+++ b/contrib/templates/example/README.rst
@@ -2,4 +2,9 @@
 Example Cluster Template
 ========================
 
+The purpose of this example template is to demonstrate working with cluster
+templates using magnum service.
+The Heat template used in this example (example.yaml) provisions a single
+server instance and does not produce a usable cluster.
+
 See `<http://docs.openstack.org/developer/magnum/dev/cluster-type-definition.html>`_ for instructions.
diff --git a/contrib/templates/example/example_template/example.yaml b/contrib/templates/example/example_template/example.yaml
index bd9379f502..91888a530a 100644
--- a/contrib/templates/example/example_template/example.yaml
+++ b/contrib/templates/example/example_template/example.yaml
@@ -1,7 +1,8 @@
 heat_template_version: 2014-10-16
 
 description: >
-  This is just an example template. It does not produce a usable bay.
+  This is just an example Heat template. It only provisions a single server
+  instance and does not produce a usable cluster.
 
 parameters:
   #