From 1c379a797ebfefaabba22a983f6fbd8c853879f5 Mon Sep 17 00:00:00 2001
From: Diane Fleming <diflemin@cisco.com>
Date: Fri, 11 Dec 2015 20:08:30 -0600
Subject: [PATCH] Update Orchestration API v1 to spellcheck and make other
 changes

- Remove passive voice from api-site
- Renamed api-ref/src/wadls/orchestration/src/v1/api_samples
  to .../samples
- Renamed code samples using this naming convention:
  <resource>-<action>-request.json or <resource>-<action>-response.json.
  For example, volume-create-request.json and volume-create-response.json.
- Removed unused code samples
- Made method names consistent throughout - use list<resource> for list
  operations, show<resource> for show operations, and so on.

Change-Id: Icbd0e6651615165f3185e048edf02e210ca0759e
Partial-Bug: #1521244
---
 .../wadls/orchestration-api/src/v1/common.ent |  40 ++++---
 .../src/v1/orchestration-api.wadl             | 100 +++++++++---------
 ...nfo-resp.json => build-info-response.json} |   0
 ...te-req.json => config-create-request.json} |   0
 ...-resp.json => config-create-response.json} |   0
 ...ow-resp.json => config-show-response.json} |   0
 ...eq.json => deployment-create-request.json} |   0
 ...p.json => deployment-create-response.json} |   0
 ...json => deployment-metadata-response.json} |   0
 ...esp.json => deployment-show-response.json} |   0
 ...eq.json => deployment-update-request.json} |   0
 ...p.json => deployment-update-response.json} |   0
 ...sp.json => deployments-list-response.json} |   0
 ...how-resp.json => event-show-response.json} |   0
 ...st-resp.json => events-list-response.json} |   0
 ...-resp.json => heat-versions-response.json} |   0
 ...p.json => resource-metadata-response.json} |   0
 ...esp.json => resource-schema-response.json} |   0
 ...-resp.json => resource-show-response.json} |   0
 ...n => resource-type-template-response.json} |   0
 ...json => resource-types-list-response.json} |   0
 ...resp.json => resources-list-response.json} |   0
 ...-resp.json => services-list-response.json} |   0
 ...-resp.json => stack-abandon-response.json} |   0
 ...> stack-action-cancel-update-request.json} |   0
 ...q.json => stack-action-check-request.json} |   0
 ....json => stack-action-resume-request.json} |   0
 ...json => stack-action-suspend-request.json} |   0
 ...dopt-req.json => stack-adopt-request.json} |   0
 ...pt-resp.json => stack-adopt-response.json} |   0
 ...ate-req.json => stack-create-request.json} |   0
 ...e-resp.json => stack-create-response.json} |   0
 ...ind-resp.json => stack-find-response.json} |   0
 ....json => stack-outputs-list-response.json} |   0
 ...-resp.json => stack-preview-response.json} |   0
 ...p.json => stack-show-output-response.json} |   0
 ...how-resp.json => stack-show-response.json} |   0
 ...json => stack-show-snapshot-response.json} |   0
 ...t-req.json => stack-snapshot-request.json} |   0
 ...resp.json => stack-snapshot-response.json} |   0
 ...son => stack-snapshots-list-response.json} |   0
 ...son => stack-update-preview-response.json} |   0
 ...ate-req.json => stack-update-request.json} |   0
 ...st-resp.json => stacks-list-response.json} |   0
 ...-resp.json => template-show-response.json} |   0
 ...eq.json => template-validate-request.json} |   0
 ...p.json => template-validate-response.json} |   0
 47 files changed, 75 insertions(+), 65 deletions(-)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{build-info-resp.json => build-info-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{config-create-req.json => config-create-request.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{config-create-resp.json => config-create-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{config-show-resp.json => config-show-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{deployment-create-req.json => deployment-create-request.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{deployment-create-resp.json => deployment-create-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{deployment-metadata-resp.json => deployment-metadata-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{deployment-show-resp.json => deployment-show-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{deployment-update-req.json => deployment-update-request.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{deployment-update-resp.json => deployment-update-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{deployment-list-resp.json => deployments-list-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{event-show-resp.json => event-show-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{event-list-resp.json => events-list-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{heat-versions-resp.json => heat-versions-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{resource-metadata-resp.json => resource-metadata-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{resource-schema-resp.json => resource-schema-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{resource-show-resp.json => resource-show-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{resource-type-template-resp.json => resource-type-template-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{resource-type-list-resp.json => resource-types-list-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{resource-list-resp.json => resources-list-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{service-list-resp.json => services-list-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{stack-abandon-resp.json => stack-abandon-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{stack-action-cancel-update-req.json => stack-action-cancel-update-request.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{stack-action-check-req.json => stack-action-check-request.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{stack-action-resume-req.json => stack-action-resume-request.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{stack-action-suspend-req.json => stack-action-suspend-request.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{stack-adopt-req.json => stack-adopt-request.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{stack-adopt-resp.json => stack-adopt-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{stack-create-req.json => stack-create-request.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{stack-create-resp.json => stack-create-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{stack-find-resp.json => stack-find-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{stack-list-outputs-resp.json => stack-outputs-list-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{stack-preview-resp.json => stack-preview-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{stack-show-output-resp.json => stack-show-output-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{stack-show-resp.json => stack-show-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{stack-show-snapshot-resp.json => stack-show-snapshot-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{stack-snapshot-req.json => stack-snapshot-request.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{stack-snapshot-resp.json => stack-snapshot-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{stack-list-snapshot-resp.json => stack-snapshots-list-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{stack-update-preview-resp.json => stack-update-preview-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{stack-update-req.json => stack-update-request.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{stack-list-resp.json => stacks-list-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{template-show-resp.json => template-show-response.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{template-validate-req.json => template-validate-request.json} (100%)
 rename api-ref/src/wadls/orchestration-api/src/v1/samples/{template-validate-resp.json => template-validate-response.json} (100%)

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 7b433d48b..6eb19ea45 100644
--- a/api-ref/src/wadls/orchestration-api/src/v1/common.ent
+++ b/api-ref/src/wadls/orchestration-api/src/v1/common.ent
@@ -106,13 +106,19 @@
       provider template functionality use this mapping. When you want to
       use a provider template, for example, the Orchestration service
       adds an entry to the <code>files</code> map by using:
-   <itemizedlist>
-   <listitem><para>The URL
-      of the provider template as the name.</para></listitem>
-   <listitem><para>The contents of that file as
-      the value.</para></listitem>
-   </itemizedlist>
    </para>
+   <itemizedlist>
+   <listitem>
+      <para>
+         The URL of the provider template as the name.
+      </para>
+   </listitem>
+   <listitem>
+      <para>
+         The contents of that file as the value.
+      </para>
+   </listitem>
+   </itemizedlist>
    <para>
       Additionally, some template authors encode their user data in a local
       file. The Orchestration client examines the template for the
@@ -145,7 +151,8 @@
 </wadl:doc>
 </param>'>
 <!ENTITY sortKeys '
-   <param xmlns="http://wadl.dev.java.net/2009/02" name="sort_keys" style="query" required="false">
+<param xmlns="http://wadl.dev.java.net/2009/02"
+   name="sort_keys" style="query" required="false">
 <wadl:doc xmlns="http://docbook.org/ns/docbook"
    xmlns:wadl="http://wadl.dev.java.net/2009/02"
    xml:lang="EN">
@@ -167,7 +174,8 @@
 </wadl:doc>
 </param> '>
 <!ENTITY templateUrlParameter '
-<param xmlns="http://wadl.dev.java.net/2009/02" name="template_url" style="plain" required="false">
+<param xmlns="http://wadl.dev.java.net/2009/02"
+   name="template_url" style="plain" required="false">
 <wadl:doc xmlns="http://docbook.org/ns/docbook"
    xmlns:wadl="http://wadl.dev.java.net/2009/02"
    xml:lang="EN">
@@ -254,13 +262,15 @@
 </wadl:doc>
 </param> '>
 <!ENTITY paramNameNParameterOptional '
-<param xmlns="http://wadl.dev.java.net/2009/02" name="param_name-n" style="plain" required="false">
-<wadl:doc xmlns="http://docbook.org/ns/docbook" xmlns:wadl="http://wadl.dev.java.net/2009/02"
-   xml:lang="EN">
-   <para>
-      User-defined parameter names to pass to the template.
-   </para>
-</wadl:doc>
+<param xmlns="http://wadl.dev.java.net/2009/02"
+   name="param_name-n" style="plain" required="false">
+   <wadl:doc xmlns="http://docbook.org/ns/docbook"
+      xmlns:wadl="http://wadl.dev.java.net/2009/02"
+      xml:lang="EN">
+      <para>
+         User-defined parameter names to pass to the template.
+      </para>
+   </wadl:doc>
 </param> '>
 <!ENTITY paramValueNParameter '
 <param xmlns="http://wadl.dev.java.net/2009/02" name="param_value-n" style="plain" required="true">
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 4e7d90708..05800cf4b 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
@@ -18,7 +18,7 @@
    <resources base="https://heat.example.com/"
       xml:id="orchestration-api-v1.0">
       <resource id="versions" path="//">
-         <method href="#getVersions-heat-v1"/>
+         <method href="#listVersions-heat-v1"/>
       </resource>
       <resource id="version" path="//v1">
          <resource id="tenant_id" path="{tenant_id}">
@@ -292,7 +292,7 @@
          </resource>
       </resource>
    </resources>
-   <method name="GET" id="getVersions-heat-v1">
+   <method name="GET" id="listVersions-heat-v1">
       <wadl:doc xml:lang="EN" title="List versions" xmlns:wadl="http://wadl.dev.java.net/2009/02"
          xmlns="http://docbook.org/ns/docbook">
          <para role="shortdesc">
@@ -304,7 +304,7 @@
             <wadl:doc xmlns="http://docbook.org/ns/docbook" xmlns:wadl="http://wadl.dev.java.net/2009/02"
                xml:lang="EN">
                <xsdxt:code
-                  href="samples/heat-versions-resp.json"/>
+                  href="samples/heat-versions-response.json"/>
             </wadl:doc>
          </representation>
       </response>
@@ -485,7 +485,7 @@
          <representation mediaType="application/json">
             <wadl:doc xmlns="http://docbook.org/ns/docbook" xmlns:wadl="http://wadl.dev.java.net/2009/02"
                xml:lang="EN">
-               <xsdxt:code href="samples/stack-list-resp.json"/>
+               <xsdxt:code href="samples/stacks-list-response.json"/>
             </wadl:doc>
          </representation>
       </response>
@@ -504,7 +504,7 @@
          <representation mediaType="application/json">
             <wadl:doc xmlns="http://docbook.org/ns/docbook" xmlns:wadl="http://wadl.dev.java.net/2009/02"
                xml:lang="EN">
-               <xsdxt:code href="samples/stack-create-req.json"/>
+               <xsdxt:code href="samples/stack-create-request.json"/>
             </wadl:doc>
             <param xmlns="http://wadl.dev.java.net/2009/02" name="stack_name" style="plain" required="true">
             <wadl:doc xmlns="http://docbook.org/ns/docbook" xmlns:wadl="http://wadl.dev.java.net/2009/02"
@@ -545,7 +545,7 @@
          <representation mediaType="application/json">
             <wadl:doc xmlns="http://docbook.org/ns/docbook" xmlns:wadl="http://wadl.dev.java.net/2009/02"
                xml:lang="EN">
-               <xsdxt:code href="samples/stack-create-resp.json"
+               <xsdxt:code href="samples/stack-create-response.json"
                   />
             </wadl:doc>
             <param xmlns="http://wadl.dev.java.net/2009/02" name="stack_name" style="plain" required="true">
@@ -653,7 +653,7 @@
          <representation mediaType="application/json">
             <wadl:doc xmlns="http://docbook.org/ns/docbook" xmlns:wadl="http://wadl.dev.java.net/2009/02"
                xml:lang="EN">
-               <xsdxt:code href="samples/stack-create-req.json"/>
+               <xsdxt:code href="samples/stack-create-request.json"/>
             </wadl:doc>
             <param xmlns="http://wadl.dev.java.net/2009/02" name="stack_name" style="plain" required="true">
             <wadl:doc xmlns="http://docbook.org/ns/docbook" xmlns:wadl="http://wadl.dev.java.net/2009/02"
@@ -687,7 +687,7 @@
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xmlns:wadl="http://wadl.dev.java.net/2009/02"
                xml:lang="EN">
-               <xsdxt:code href="samples/stack-preview-resp.json"/>
+               <xsdxt:code href="samples/stack-preview-response.json"/>
             </wadl:doc>
             <param xmlns="http://wadl.dev.java.net/2009/02" name="parent" style="plain" required="true">
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
@@ -826,7 +826,7 @@
          <representation mediaType="application/json">
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xml:lang="EN">
-               <xsdxt:code href="samples/stack-adopt-req.json"/>
+               <xsdxt:code href="samples/stack-adopt-request.json"/>
             </wadl:doc>
             <param xmlns="http://wadl.dev.java.net/2009/02" name="stack_name" style="plain" required="true">
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
@@ -893,7 +893,7 @@
          <representation mediaType="application/json">
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xml:lang="EN">
-               <xsdxt:code href="samples/stack-adopt-resp.json"/>
+               <xsdxt:code href="samples/stack-adopt-response.json"/>
             </wadl:doc>
          </representation>
       </response>
@@ -914,7 +914,7 @@
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xml:lang="EN">
                <xsdxt:code
-                  href="samples/stack-action-suspend-req.json"/>
+                  href="samples/stack-action-suspend-request.json"/>
             </wadl:doc>
             <param xmlns="http://wadl.dev.java.net/2009/02" name="suspend" style="plain" required="true">
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
@@ -941,7 +941,7 @@
                xmlns:wadl="http://wadl.dev.java.net/2009/02"
                xml:lang="EN">
                <xsdxt:code
-                  href="samples/stack-action-resume-req.json"/>
+                  href="samples/stack-action-resume-request.json"/>
             </wadl:doc>
             <param xmlns="http://wadl.dev.java.net/2009/02" name="resume" style="plain" required="true">
             <wadl:doc xmlns="http://docbook.org/ns/docbook" xml:lang="EN">
@@ -967,7 +967,7 @@
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xml:lang="EN">
                <xsdxt:code
-                  href="samples/stack-action-cancel-update-req.json"/>
+                  href="samples/stack-action-cancel-update-request.json"/>
             </wadl:doc>
             <param xmlns="http://wadl.dev.java.net/2009/02" name="cancel_update" style="plain" required="true">
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
@@ -995,7 +995,7 @@
                xmlns:wadl="http://wadl.dev.java.net/2009/02"
                xml:lang="EN">
                <xsdxt:code
-                  href="samples/stack-action-check-req.json"/>
+                  href="samples/stack-action-check-request.json"/>
             </wadl:doc>
             <param xmlns="http://wadl.dev.java.net/2009/02" name="check" style="plain" required="true">
             <wadl:doc xmlns="http://docbook.org/ns/docbook" xml:lang="EN">
@@ -1029,7 +1029,7 @@
          <representation mediaType="application/json">
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xml:lang="EN">
-               <xsdxt:code href="samples/stack-find-resp.json"/>
+               <xsdxt:code href="samples/stack-find-response.json"/>
             </wadl:doc>
          </representation>
       </response>
@@ -1049,7 +1049,7 @@
          <representation mediaType="application/json">
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xml:lang="EN">
-               <xsdxt:code href="samples/stack-show-resp.json"/>
+               <xsdxt:code href="samples/stack-show-response.json"/>
             </wadl:doc>
             &stackResponseParameters;
          </representation>
@@ -1072,7 +1072,7 @@
             <para xmlns="http://docbook.org/ns/docbook">
                Returns the template for a stack.
             </para>
-            <xsdxt:code href="samples/template-show-resp.json"/>
+            <xsdxt:code href="samples/template-show-response.json"/>
           </wadl:doc>
           &templateResponseParameters;
         </representation>
@@ -1093,7 +1093,7 @@
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xmlns:wadl="http://wadl.dev.java.net/2009/02"
                xml:lang="EN">
-               <xsdxt:code href="samples/stack-update-req.json"/>
+               <xsdxt:code href="samples/stack-update-request.json"/>
             </wadl:doc>
             &templateUrlParameter;
             &templateParameter;
@@ -1171,7 +1171,7 @@
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xmlns:wadl="http://wadl.dev.java.net/2009/02"
                xml:lang="EN">
-               <xsdxt:code href="samples/stack-update-req.json"/>
+               <xsdxt:code href="samples/stack-update-request.json"/>
             </wadl:doc>
             &templateUrlParameter;
             &templateParameter;
@@ -1236,7 +1236,7 @@
            <representation mediaType="application/json">
                <wadl:doc xmlns="http://docbook.org/ns/docbook"
                    xml:lang="EN">
-                   <xsdxt:code href="samples/stack-update-preview-resp.json"/>
+                   <xsdxt:code href="samples/stack-update-preview-response.json"/>
                </wadl:doc>
            </representation>
        </response>
@@ -1270,7 +1270,7 @@
          <representation mediaType="application/json">
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xml:lang="EN">
-               <xsdxt:code href="samples/stack-abandon-resp.json"/>
+               <xsdxt:code href="samples/stack-abandon-response.json"/>
             </wadl:doc>
          </representation>
       </response>
@@ -1291,7 +1291,7 @@
          <representation mediaType="application/json">
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xml:lang="EN">
-               <xsdxt:code href="samples/stack-snapshot-req.json"/>
+               <xsdxt:code href="samples/stack-snapshot-request.json"/>
             </wadl:doc>
             <param xmlns="http://wadl.dev.java.net/2009/02" name="name" style="plain"
                required="true">
@@ -1309,7 +1309,7 @@
          <representation mediaType="application/json">
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xml:lang="EN">
-               <xsdxt:code href="samples/stack-snapshot-resp.json"/>
+               <xsdxt:code href="samples/stack-snapshot-response.json"/>
             </wadl:doc>
          </representation>
       </response>
@@ -1326,7 +1326,7 @@
          <representation mediaType="application/json">
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xml:lang="EN">
-               <xsdxt:code href="samples/stack-list-snapshot-resp.json"/>
+               <xsdxt:code href="samples/stack-snapshots-list-response.json"/>
             </wadl:doc>
             &snapshotsParameter;
             &snapshotcommonParameters;
@@ -1345,7 +1345,7 @@
          <representation mediaType="application/json">
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xml:lang="EN">
-               <xsdxt:code href="samples/stack-show-snapshot-resp.json"/>
+               <xsdxt:code href="samples/stack-show-snapshot-response.json"/>
             </wadl:doc>
             &snapshotResponseParameters;
             &snapshotcommonParameters;
@@ -1387,7 +1387,7 @@
          <representation mediaType="application/json">
          <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xml:lang="EN">
-               <xsdxt:code href="samples/stack-list-outputs-resp.json"/>
+               <xsdxt:code href="samples/stack-outputs-list-response.json"/>
             </wadl:doc>
          </representation>
       </response>
@@ -1404,7 +1404,7 @@
          <representation mediaType="application/json">
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xml:lang="EN">
-               <xsdxt:code href="samples/stack-show-output-resp.json"/>
+               <xsdxt:code href="samples/stack-show-output-response.json"/>
             </wadl:doc>
          </representation>
       </response>
@@ -1421,7 +1421,7 @@
          <representation mediaType="application/json">
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xml:lang="EN">
-               <xsdxt:code href="samples/template-validate-req.json"
+               <xsdxt:code href="samples/template-validate-request.json"
                   />
             </wadl:doc>
             &templateUrlParameter;
@@ -1434,7 +1434,7 @@
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xmlns:wadl="http://wadl.dev.java.net/2009/02"
                xml:lang="EN">
-               <xsdxt:code href="samples/template-validate-resp.json"/>
+               <xsdxt:code href="samples/template-validate-response.json"/>
             </wadl:doc>
             <param xmlns="http://wadl.dev.java.net/2009/02"
              name="Description" style="plain" required="true">
@@ -1540,7 +1540,7 @@
       <response status="200">
          <representation mediaType="application/json">
            <wadl:doc xmlns="http://docbook.org/ns/docbook" xml:lang="EN">
-             <xsdxt:code href="samples/resource-type-list-resp.json"/>
+             <xsdxt:code href="samples/resource-types-list-response.json"/>
            </wadl:doc>
          </representation>
       </response>
@@ -1564,7 +1564,7 @@
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xmlns:wadl="http://wadl.dev.java.net/2009/02"
                xml:lang="EN">
-               <xsdxt:code href="samples/resource-schema-resp.json"/>
+               <xsdxt:code href="samples/resource-schema-response.json"/>
             </wadl:doc>
             &templateResponseParameters;
          </representation>
@@ -1597,7 +1597,7 @@
       <response status="200">
         <representation mediaType="application/json" >
           <wadl:doc xmlns="http://docbook.org/ns/docbook" xml:lang="EN">
-            <xsdxt:code href="samples/resource-type-template-resp.json"/>
+            <xsdxt:code href="samples/resource-type-template-response.json"/>
           </wadl:doc>
         </representation>
       </response>
@@ -1667,7 +1667,7 @@
             <para xmlns="http://docbook.org/ns/docbook">
                Lists resources in a stack, in JSON format.
             </para>
-            <xsdxt:code href="samples/resource-list-resp.json"/>
+            <xsdxt:code href="samples/resources-list-response.json"/>
           </wadl:doc>
           &resourcesParameter;
           &stackresourceResponseParameters;
@@ -1689,7 +1689,7 @@
             <para xmlns="http://docbook.org/ns/docbook">
                Shows resource data for a resource, in JSON format.
             </para>
-            <xsdxt:code href="samples/resource-show-resp.json"/>
+            <xsdxt:code href="samples/resource-show-response.json"/>
           </wadl:doc>
           &stackresourceResponseParameters;
         </representation>
@@ -1709,7 +1709,7 @@
          <representation mediaType="application/json">
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xml:lang="EN">
-               <xsdxt:code href="samples/resource-metadata-resp.json"/>
+               <xsdxt:code href="samples/resource-metadata-response.json"/>
             </wadl:doc>
          </representation>
       </response>
@@ -1816,7 +1816,7 @@
          <representation mediaType="application/json">
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xml:lang="EN">
-               <xsdxt:code href="samples/event-list-resp.json"/>
+               <xsdxt:code href="samples/events-list-response.json"/>
             </wadl:doc>
          </representation>
       </response>
@@ -1888,7 +1888,7 @@
          <representation mediaType="application/json">
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xml:lang="EN">
-               <xsdxt:code href="samples/event-list-resp.json"/>
+               <xsdxt:code href="samples/events-list-response.json"/>
             </wadl:doc>
          </representation>
       </response>
@@ -1902,7 +1902,7 @@
          <para role="shortdesc">
             Shows details for an event.
          </para>
-         <xsdxt:code href="samples/event-show-resp.json"/>
+         <xsdxt:code href="samples/event-show-response.json"/>
       </wadl:doc>
       <response status="200">
          <representation mediaType="application/json"/>
@@ -1920,7 +1920,7 @@
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xmlns:wadl="http://wadl.dev.java.net/2009/02"
                xml:lang="EN">
-               <xsdxt:code href="samples/build-info-resp.json"/>
+               <xsdxt:code href="samples/build-info-response.json"/>
             </wadl:doc>
          </representation>
       </response>
@@ -1937,7 +1937,7 @@
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xmlns:wadl="http://wadl.dev.java.net/2009/02"
                xml:lang="EN">
-               <xsdxt:code href="samples/config-create-req.json"
+               <xsdxt:code href="samples/config-create-request.json"
                   />
             </wadl:doc>
             <param xmlns="http://wadl.dev.java.net/2009/02"
@@ -2009,7 +2009,7 @@
          <representation mediaType="application/json">
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xml:lang="EN">
-               <xsdxt:code href="samples/config-create-resp.json"
+               <xsdxt:code href="samples/config-create-response.json"
                   />
             </wadl:doc>
             &softwareconfigResponseParameters;
@@ -2030,7 +2030,7 @@
          <representation mediaType="application/json">
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xml:lang="EN">
-               <xsdxt:code href="samples/config-show-resp.json"/>
+               <xsdxt:code href="samples/config-show-response.json"/>
             </wadl:doc>
             &softwareconfigResponseParameters;
          </representation>
@@ -2060,7 +2060,7 @@
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xmlns:wadl="http://wadl.dev.java.net/2009/02"
                xml:lang="EN">
-               <xsdxt:code href="samples/deployment-list-resp.json"/>
+               <xsdxt:code href="samples/deployments-list-response.json"/>
             </wadl:doc>
             &softwaredeploymentResponseParameters;
          </representation>
@@ -2086,7 +2086,7 @@
                xmlns:wadl="http://wadl.dev.java.net/2009/02"
                xml:lang="EN">
                <xsdxt:code
-                  href="samples/deployment-metadata-resp.json"/>
+                  href="samples/deployment-metadata-response.json"/>
             </wadl:doc>
          </representation>
       </response>
@@ -2104,7 +2104,7 @@
                xmlns:wadl="http://wadl.dev.java.net/2009/02"
                xml:lang="EN">
                <xsdxt:code
-                  href="samples/deployment-create-req.json"/>
+                  href="samples/deployment-create-request.json"/>
             </wadl:doc>
             <param xmlns="http://wadl.dev.java.net/2009/02"
              name="config_id" style="plain" required="true">
@@ -2179,7 +2179,7 @@
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xml:lang="EN">
                <xsdxt:code
-                  href="samples/deployment-create-resp.json"/>
+                  href="samples/deployment-create-response.json"/>
             </wadl:doc>
             &softwaredeploymentResponseParameters;
          </representation>
@@ -2197,7 +2197,7 @@
          <representation mediaType="application/json">
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xml:lang="EN">
-               <xsdxt:code href="samples/deployment-show-resp.json"/>
+               <xsdxt:code href="samples/deployment-show-response.json"/>
             </wadl:doc>
             &softwaredeploymentResponseParameters;
          </representation>
@@ -2216,7 +2216,7 @@
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xml:lang="EN">
                <xsdxt:code
-                  href="samples/deployment-update-req.json"/>
+                  href="samples/deployment-update-request.json"/>
             </wadl:doc>
             <param xmlns="http://wadl.dev.java.net/2009/02"
              name="config_id" style="plain" required="true">
@@ -2284,7 +2284,7 @@
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xml:lang="EN">
                <xsdxt:code
-                  href="samples/deployment-update-resp.json"/>
+                  href="samples/deployment-update-response.json"/>
             </wadl:doc>
             &softwaredeploymentResponseParameters;
          </representation>
@@ -2329,7 +2329,7 @@
             <wadl:doc xmlns="http://docbook.org/ns/docbook"
                xmlns:wadl="http://wadl.dev.java.net/2009/02"
                xml:lang="EN">
-               <xsdxt:code href="samples/service-list-resp.json"/>
+               <xsdxt:code href="samples/services-list-response.json"/>
             </wadl:doc>
          </representation>
       </response>
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/build-info-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/build-info-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/build-info-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/build-info-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/config-create-req.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/config-create-request.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/config-create-req.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/config-create-request.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/config-create-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/config-create-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/config-create-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/config-create-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/config-show-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/config-show-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/config-show-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/config-show-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/deployment-create-req.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/deployment-create-request.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/deployment-create-req.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/deployment-create-request.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/deployment-create-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/deployment-create-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/deployment-create-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/deployment-create-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/deployment-metadata-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/deployment-metadata-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/deployment-metadata-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/deployment-metadata-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/deployment-show-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/deployment-show-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/deployment-show-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/deployment-show-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/deployment-update-req.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/deployment-update-request.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/deployment-update-req.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/deployment-update-request.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/deployment-update-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/deployment-update-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/deployment-update-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/deployment-update-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/deployment-list-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/deployments-list-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/deployment-list-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/deployments-list-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/event-show-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/event-show-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/event-show-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/event-show-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/event-list-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/events-list-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/event-list-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/events-list-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/heat-versions-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/heat-versions-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/heat-versions-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/heat-versions-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/resource-metadata-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/resource-metadata-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/resource-metadata-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/resource-metadata-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/resource-schema-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/resource-schema-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/resource-schema-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/resource-schema-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/resource-show-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/resource-show-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/resource-show-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/resource-show-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/resource-type-template-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/resource-type-template-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/resource-type-template-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/resource-type-template-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/resource-type-list-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/resource-types-list-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/resource-type-list-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/resource-types-list-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/resource-list-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/resources-list-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/resource-list-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/resources-list-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/service-list-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/services-list-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/service-list-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/services-list-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-abandon-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-abandon-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/stack-abandon-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/stack-abandon-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-action-cancel-update-req.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-action-cancel-update-request.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/stack-action-cancel-update-req.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/stack-action-cancel-update-request.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-action-check-req.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-action-check-request.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/stack-action-check-req.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/stack-action-check-request.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-action-resume-req.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-action-resume-request.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/stack-action-resume-req.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/stack-action-resume-request.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-action-suspend-req.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-action-suspend-request.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/stack-action-suspend-req.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/stack-action-suspend-request.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-adopt-req.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-adopt-request.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/stack-adopt-req.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/stack-adopt-request.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-adopt-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-adopt-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/stack-adopt-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/stack-adopt-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-create-req.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-create-request.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/stack-create-req.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/stack-create-request.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-create-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-create-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/stack-create-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/stack-create-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-find-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-find-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/stack-find-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/stack-find-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-list-outputs-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-outputs-list-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/stack-list-outputs-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/stack-outputs-list-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-preview-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-preview-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/stack-preview-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/stack-preview-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-show-output-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-show-output-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/stack-show-output-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/stack-show-output-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-show-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-show-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/stack-show-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/stack-show-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-show-snapshot-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-show-snapshot-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/stack-show-snapshot-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/stack-show-snapshot-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-snapshot-req.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-snapshot-request.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/stack-snapshot-req.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/stack-snapshot-request.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-snapshot-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-snapshot-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/stack-snapshot-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/stack-snapshot-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-list-snapshot-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-snapshots-list-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/stack-list-snapshot-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/stack-snapshots-list-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-update-preview-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-update-preview-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/stack-update-preview-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/stack-update-preview-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-update-req.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-update-request.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/stack-update-req.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/stack-update-request.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/stack-list-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/stacks-list-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/stack-list-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/stacks-list-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/template-show-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/template-show-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/template-show-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/template-show-response.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/template-validate-req.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/template-validate-request.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/template-validate-req.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/template-validate-request.json
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/samples/template-validate-resp.json b/api-ref/src/wadls/orchestration-api/src/v1/samples/template-validate-response.json
similarity index 100%
rename from api-ref/src/wadls/orchestration-api/src/v1/samples/template-validate-resp.json
rename to api-ref/src/wadls/orchestration-api/src/v1/samples/template-validate-response.json