Added pointers to template documentation.

Also added "Heat Orchestration Template" and "Stack"
to the glossary.

Also made a few other changes suggested by reviewers.

Change-Id: I9856f9664cc104eda7a37d9a0a43ee1a0e534aca
Closes-Bug: 1281691

doc/glossary/glossary-terms.xml

@@ -2184,6 +2184,13 @@
                     multiple cloud applications for OpenStack.</para>
             </glossdef>
         </glossentry>
+        <glossentry>
+            <glossterm>Heat Orchestration Template (HOT)</glossterm>
+            <glossdef>
+                <para>Heat input in the format native to
+                    OpenStack.</para>
+            </glossdef>
+        </glossentry>
         <glossentry>
             <glossterm>horizon</glossterm>
             <glossdef>
@@ -4303,6 +4310,16 @@
                     services.</para>
             </glossdef>
         </glossentry>
+        <glossentry>
+            <glossterm>stack</glossterm>
+            <glossdef>
+                <para>A set of OpenStack resources created and managed by
+                  the Orchestration service according to a given template
+                  (either an AWS CloudFormation template or a
+                  <glossterm>Heat Orchestration Template
+                    (HOT)</glossterm>).</para>
+            </glossdef>
+        </glossentry>
         <glossentry>
             <glossterm>StackTach</glossterm>
             <glossdef>

doc/user-guide/section_cli_heat.xml

@@ -7,6 +7,12 @@
     xml:id="heat-stack-create">
     <?dbhtml stop-chunking?>
     <title>Create and manage stacks</title>
+    <para>The template languages are described in
+        <link
+        xlink:href="http://docs.openstack.org/developer/heat/template_guide/index.html"
+        >the Template Guide</link> in the <link
+        xlink:href="http://docs.openstack.org/developer/heat/">Heat
+        developer documentation</link>.</para>
     <section xml:id="create_stack">
         <title>Create a stack from an example template file</title>
         <procedure>

doc/user-guide/section_dashboard_stacks.xml

@@ -10,17 +10,26 @@
     xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
     xml:id="dashboard_stacks">
     <title>Launch and manage stacks</title>
-    <para>Orchestration is a service used to orchestrate
+
-        multiple composite cloud applications using the AWS
+    <para>Use the Orchestration service to orchestrate multiple
-        CloudFormation template format, through both an
+        composite cloud applications. This service supports use of both
-        OpenStack-native REST API and a CloudFormation-compatible
+        the AWS CloudFormation template format through a Query API and
-        Query API.</para>
+        the OpenStack-native
-    <para>The flexible template language enables application
+        <glossterm>Heat Orchestration Template (HOT)</glossterm> format
+        through a REST API.</para>
+
+    <para>These flexible template languages enable application
         developers to describe and automate the deployment of
         infrastructure, services, and applications. The templates
         allow creation of most OpenStack resource types such as
-        instances, floating ips, volumes, security groups, users, and
+        instances, floating IPs, volumes, security groups, and
-        so on.</para>
+        users.</para>
+    <para>The template languages are described in
+        <link
+        xlink:href="http://docs.openstack.org/developer/heat/template_guide/index.html"
+        >the Template Guide</link> in the <link
+        xlink:href="http://docs.openstack.org/developer/heat/">Heat
+        developer documentation</link>.</para>
     <section xml:id="dashboard_create_stacks">
         <title>Launch a stack</title>
         <procedure>