diff --git a/README.md b/README.md
index 0194f309..bba71453 100644
--- a/README.md
+++ b/README.md
@@ -39,6 +39,34 @@ Setup
 
 ### Beginning with heat
 
+To utilize the heat module's functionality you will need to declare multiple resources.
+The following is a modified excerpt from the [openstack module](httpd://github.com/stackforge/puppet-openstack).
+This is not an exhaustive list of all the components needed. We recommend that you consult and understand the
+[openstack module](https://github.com/stackforge/puppet-openstack) and the [core openstack](http://docs.openstack.org)
+documentation to assist you in understanding the available deployment options.
+
+```puppet
+# enable heat resources
+class { '::heat':
+  rabbit_userid       => 'heat',
+  rabbit_password     => 'an_even_bigger_secret',
+  rabbit_host         => '127.0.0.1',
+  database_connection => 'mysql://heat:a_big_secret@127.0.0.1/heat?charset=utf8',
+  identity_uri        => 'http://127.0.0.1:35357/',
+  keystone_password   => 'a_big_secret',
+}
+
+class { '::heat::api': }
+
+class { '::heat::engine':
+  auth_encryption_key => '1234567890AZERTYUIOPMLKJHGFDSQ12',
+}
+
+class { '::heat::api_cloudwatch': }
+
+class { '::heat::api_cfn': }
+```
+
 Implementation
 --------------