Fix: requestBody descriptions

docs/controllers/AuthorController.yaml

@@ -147,7 +147,15 @@ paths:
       tags:
         - Authors
       requestBody:
+        required: false
+        description: The author object to create.
+        content:
+          application/json:
+            schema:
+              properties:
+                include:
                   $ref: '#/components/requestBody/authorInclude'
+                library:
                   $ref: '#/components/requestBody/authorLibraryId'
       responses:
         '200':
@@ -166,12 +174,18 @@ paths:
         - Authors
       requestBody:
         required: true
+        description: The author object to update.
         content:
           application/json:
             schema:
+              properties:
+                name:
                   $ref: '#/components/requestBody/authorName'
+                description:
                   $ref: '#/components/requestBody/authorDescription'
+                imagePath:
                   $ref: '#/components/requestBody/authorImagePath'
+                asin:
                   $ref: '#/components/requestBody/asin'
       responses:
         '200':
@@ -216,9 +230,19 @@ paths:
       tags:
         - Authors
       requestBody:
+        required: false
+        description: The author image to get.
+        content:
+          application/json:
+            schema:
+              properties:
+                width:
                   $ref: '#/components/requestBody/imageWidth'
+                height:
                   $ref: '#/components/requestBody/imageHeight'
+                format:
                   $ref: '#/components/requestBody/imageFormat'
+                raw:
                   $ref: '#/components/requestBody/imageRaw'
       responses:
         '200':
@@ -248,6 +272,7 @@ paths:
         $ref: '#/components/requestBody/imageUrl'
       requestBody:
         required: true
+        description: The author image to add by URL.
         content:
           application/json:
             schema:
@@ -269,9 +294,19 @@ paths:
       tags:
         - Authors
       requestBody:
+        required: true
+        description: The author image to update.
+        content:
+          application/json:
+            schema:
+              properties:
+                width:
                   $ref: '#/components/requestBody/imageWidth'
+                height:
                   $ref: '#/components/requestBody/imageHeight'
+                format:
                   $ref: '#/components/requestBody/imageFormat'
+                raw:
                   $ref: '#/components/requestBody/imageRaw'
       responses:
         '200':
@@ -309,8 +344,14 @@ paths:
       tags:
         - Authors
       requestBody:
-        $ref: '#/components/requestBody/asin'
-        $ref: '#/components/requestBody/authorSearchName'
+        required: true
+        description: The author object to match against an online provider.
+        content:
+          application/json:
+            schema:
+              oneOf:
+                - $ref: '#/components/requestBody/asin'
+                - $ref: '#/components/requestBody/authorSearchName'
       responses:
         '200':
           description: matchAuthorById OK

docs/controllers/LibraryController.yaml

@@ -99,6 +99,7 @@ paths:
         - Libraries
       requestBody:
         required: true
+        description: The library object to create.
         content:
           application/json:
             schema:
@@ -150,6 +151,7 @@ paths:
         - Libraries
       requestBody:
         required: true
+        description: The library object to update.
         content:
           application/json:
             schema: