Minor cleanup of OpenAPI document

Author: Aleksandar Jelenak

openapi.yaml

@@ -41,7 +41,6 @@ servers:
     description: HSDS default server
 
 
-
 components:
   schemas:
     ACL:
@@ -158,7 +157,7 @@ components:
 
 
 paths:
-  '/':
+  /:
     put:
       tags:
         - Domain
@@ -589,7 +588,7 @@ paths:
 
   # end '/groups/'
 
-  '/groups/{id}':
+  /groups/{id}:
 
     get:
       tags:
@@ -737,7 +736,7 @@ paths:
 
   # end '/groups/{id}'
 
-  '/groups/{id}/links':
+  /groups/{id}/links:
 
     get:
       tags:
@@ -1039,7 +1038,7 @@ paths:
 
   # end '/groups/{id}/links/{linkname}'
 
-  '/datasets':
+  /datasets:
 
     post:
       tags:
@@ -1527,7 +1526,7 @@ paths:
           description: Operation unsuccessful.
   #end /datasets/{id}/shape
 
-  '/datasets/{id}/type':
+  /datasets/{id}/type:
     get:
       tags:
         - Dataset
@@ -1907,7 +1906,7 @@ paths:
 
   #end /datasets/{id}/value
 
-  '/datatypes':
+  /datatypes:
 
     'post':
       tags:
@@ -2074,14 +2073,14 @@ paths:
         - Group
         - Dataset
         - Datatype
-      summary: List all Attributes attached to the given object.
-      description: Attributes sorted alphanumerially by name.
+      summary: List all Attributes attached to the HDF5 object `obj_uuid`.
+      description: Attributes sorted alphanumerically by name.
       parameters:
         - $ref: '#/components/parameters/accept_json'
         - $ref: '#/components/parameters/authorization'
         - name: collection
           in: path
-          description: Collection of objects (groups, datasets, or datatypes).
+          description: "The collection of the HDF5 object (one of: `groups`, `datasets`, or `datatypes`)."
           schema:
             type: string
             enum:
@@ -2168,21 +2167,20 @@ paths:
         - $ref: '#/components/parameters/authorization'
         - $ref: '#/components/parameters/query_domain'
         - name: collection
+          required: true
           in: path
-          description: Collection of object (Group, Dataset, or Datatype).
+          description: The collection of the HDF5 object (`groups`, `datasets`, or `datatypes`).
           schema:
             type: string
             enum:
               - groups
               - datasets
               - datatypes
-          required: true
         - name: obj_uuid
           in: path
-          description: Group/dataset/datatype UUID.
+          description: HDF5 object's UUID.
           schema:
             type: string
-            format: uuid
           required: true
         - name: attr
           in: path
@@ -2191,7 +2189,7 @@ paths:
             type: string
           required: true
       requestBody:
-        description: Attribute creation information.
+        description: Information to create a new attribute of the HDF5 object `obj_uuid`.
         required: true
         content:
           application/json:
@@ -2332,7 +2330,7 @@ paths:
 
   # end /acls
 
-  '/acls/{user}':
+  /acls/{user}:
     get:
       tags:
         - ACLS
@@ -2443,7 +2441,7 @@ paths:
 
   # end /acls/{user}
 
-  '/groups/{id}/acls':
+  /groups/{id}/acls:
 
     get:
       tags:
@@ -2484,7 +2482,7 @@ paths:
 
   # end /groups/{id}/acls
 
-  '/groups/{id}/acls/{user}':
+  /groups/{id}/acls/{user}:
 
     get:
       tags:
@@ -2530,7 +2528,7 @@ paths:
 
   # end '/groups/{id}/acls/{user}':
 
-  '/datasets/{id}/acls':
+  /datasets/{id}/acls:
     get:
       tags:
         - ACLS
@@ -2569,7 +2567,7 @@ paths:
 
   # end /datasets/{id}/acls
 
-  '/datatypes/{id}/acls':
+  /datatypes/{id}/acls:
 
     get:
       tags: