diff --git a/api-ref/src/wadls/orchestration-api/src/v1/common.ent b/api-ref/src/wadls/orchestration-api/src/v1/common.ent
index 379f9d7c8..c33625498 100644
--- a/api-ref/src/wadls/orchestration-api/src/v1/common.ent
+++ b/api-ref/src/wadls/orchestration-api/src/v1/common.ent
@@ -197,9 +197,12 @@
    </para>
    <para>
       This parameter is always provided as a <code>string</code> in the JSON
-      request body. The content of the string is a YAML- or JSON-formatted
-      Orchestration template.
+      request body. The content of the string is a JSON- or YAML-formatted
+      Orchestration template. For example:
    </para>
+   <programlisting language="json">"template": {
+    "heat_template_version": "2013-05-23",
+    ...}</programlisting>
    <para>
       This parameter is required only when you omit the
       <code>template_url</code> parameter. If you specify both parameters,
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/orchestration-api.wadl b/api-ref/src/wadls/orchestration-api/src/v1/orchestration-api.wadl
index db54a3d62..c6bc79fc9 100644
--- a/api-ref/src/wadls/orchestration-api/src/v1/orchestration-api.wadl
+++ b/api-ref/src/wadls/orchestration-api/src/v1/orchestration-api.wadl
@@ -1360,14 +1360,17 @@
          </para>
          <para>
             The canonical URL is returned for only non-deleted stacks. To
-            fetch the resource list of deleted stacks, use the <code>/v1/{tenant_id}/stacks/{stack_name}/{stack_id}/resources</code>
-            endpoint.
+            fetch the resource list for deleted stacks, use the following
+            endpoint:
          </para>
+         <programlisting>/v1/{tenant_id}/stacks/{stack_name}/{stack_id}/resources</programlisting>
       </wadl:doc>
       <response status="302">
         <representation mediaType="application/json" >
           <doc>
-            <para xmlns="http://docbook.org/ns/docbook">Lists resources for the specified stack in JSON format.</para>
+            <para xmlns="http://docbook.org/ns/docbook">
+               Lists resources for the specified stack in JSON format.
+            </para>
           </doc>
         </representation>
       </response>
@@ -1408,7 +1411,9 @@
       <response status="200">
         <representation mediaType="application/json">
           <wadl:doc xmlns="http://docbook.org/ns/docbook" xml:lang="EN">
-            <para xmlns="http://docbook.org/ns/docbook">Lists resources in the specified stack in JSON format.</para>
+            <para xmlns="http://docbook.org/ns/docbook">
+               Lists resources in the specified stack in JSON format.
+            </para>
             <xsdxt:code href="samples/resource_list_resp.json"/>
           </wadl:doc>
         </representation>