cleanup comments

Author: blewisCycle

platform/api.yml

@@ -735,7 +735,7 @@ paths:
 
   ## Stack Builds
   "/v1/stacks/builds":
-    $ref: "./paths/stacks/builds/allBuilds.yml"
+    $ref: "./paths/stacks/builds/all-builds.yml"
   "/v1/stacks/builds/{buildId}":
     $ref: "./paths/stacks/builds/lookup.yml"
   "/v1/stacks/{stackId}/builds":

…atform/paths/stacks/builds/allBuilds.yml …tform/paths/stacks/builds/all-builds.ymlplatform/paths/stacks/builds/allBuilds.yml renamed to platform/paths/stacks/builds/all-builds.yml platform/paths/stacks/builds/allBuilds.yml renamed to platform/paths/stacks/builds/all-builds.yml

@@ -1,7 +1,10 @@
 get:
   operationId: "getAllStackBuilds"
   summary: List All Builds
-  description: Requires the `stacks-view` capability.
+  description: |
+    Fetches all stack builds regardless of their association to a stack.
+
+    Requires the `stacks-view` capability.
   tags:
     - Stack Builds
   parameters:
@@ -43,7 +46,7 @@ get:
     - $ref: ../../../../components/parameters/PageParam.yml
   responses:
     200:
-      description: Returns a list of Stack Builds.
+      description: Returns a list of stack builds.
       content:
         application/json:
           schema: