docs: Move 'parameter.schema.description' to 'parameter'

As noted in a bug against the spec [1], there is some duplication here.
Go with the more obvious path until that confusion is cleared up.

[1] https://github.com/OAI/OpenAPI-Specification/issues/1788

Signed-off-by: Stephen Finucane <stephen@that.guru>

4 files changed, 196 insertions, 196 deletions

diff --git a/docs/api/schemas/latest/patchwork.yaml b/docs/api/schemas/latest/patchwork.yaml
index 9bc6f66..1510b2a 100644
--- a/docs/api/schemas/latest/patchwork.yaml
+++ b/docs/api/schemas/latest/patchwork.yaml
@@ -38,20 +38,20 @@ paths:
       - $ref: '#/components/parameters/Search'
       - in: query
         name: project
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: owner
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: public
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -76,8 +76,8 @@ paths:
       - in: path
         name: id
         required: true
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -108,20 +108,20 @@ paths:
       - $ref: '#/components/parameters/SinceFilter'
       - in: query
         name: project
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: series
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: submitter
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -145,9 +145,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -172,9 +172,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       - $ref: '#/components/parameters/Page'
@@ -214,14 +214,14 @@ paths:
       - $ref: '#/components/parameters/SinceFilter'
       - in: query
         name: project
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: category
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
           enum:
@@ -235,20 +235,20 @@ paths:
             - series-completed
       - in: query
         name: series
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: patch
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: cover
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -297,38 +297,38 @@ paths:
       - $ref: '#/components/parameters/SinceFilter'
       - in: query
         name: project
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: series
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: submitter
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: delegate
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: state
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: archived
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -352,13 +352,11 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
-      tags:
-      - patches
       responses:
         '200':
           description: ''
@@ -372,6 +370,8 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Error'
+      tags:
+      - patches
     patch:
       description: Update a patch (partial).
       operationId: patches_partial_update
@@ -381,9 +381,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       requestBody:
@@ -424,9 +424,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       requestBody:
@@ -465,9 +465,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       - $ref: '#/components/parameters/Page'
@@ -501,9 +501,9 @@ paths:
       parameters:
       - in: path
         name: patch_id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       - $ref: '#/components/parameters/Page'
@@ -514,20 +514,20 @@ paths:
       - $ref: '#/components/parameters/SinceFilter'
       - in: query
         name: user
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: state
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: context
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -559,9 +559,9 @@ paths:
       parameters:
       - in: path
         name: patch_id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       requestBody:
@@ -600,16 +600,16 @@ paths:
       parameters:
       - in: path
         name: patch_id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       - in: path
         name: check_id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -669,9 +669,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -725,9 +725,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -754,9 +754,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       requestBody:
@@ -797,9 +797,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       requestBody:
@@ -844,14 +844,14 @@ paths:
       - $ref: '#/components/parameters/SinceFilter'
       - in: query
         name: submitter
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: project
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -875,9 +875,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -937,9 +937,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: A unique integer value identifying this user.
         required: true
         schema:
-          description: A unique integer value identifying this user.
           title: ID
           type: integer
       responses:
@@ -972,9 +972,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: A unique integer value identifying this user.
         required: true
         schema:
-          description: A unique integer value identifying this user.
           title: ID
           type: integer
       requestBody:
@@ -1015,9 +1015,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: A unique integer value identifying this user.
         required: true
         schema:
-          description: A unique integer value identifying this user.
           title: ID
           type: integer
       requestBody:
@@ -1061,43 +1061,43 @@ components:
     Page:
       in: query
       name: page
+      description: A page number within the paginated result set.
       schema:
-        description: A page number within the paginated result set.
         title: Page
         type: integer
     PageSize:
       in: query
       name: per_page
+      description: Number of results to return per page.
       schema:
-        description: Number of results to return per page.
         title: Page size
         type: integer
     Order:
       in: query
       name: order
+      description: Which field to use when ordering the results.
       schema:
-        description: Which field to use when ordering the results.
         title: Ordering
         type: string
     Search:
       in: query
       name: q
+      description: A search term.
       schema:
-        description: A search term.
         title: Search
         type: string
     BeforeFilter:
       in: query
       name: before
+      description: ''
       schema:
-        description: ''
         title: ''
         type: string
     SinceFilter:
       in: query
       name: since
+      description: ''
       schema:
-        description: ''
         title: ''
         type: string
   headers:
diff --git a/docs/api/schemas/patchwork.j2 b/docs/api/schemas/patchwork.j2
index e411b8f..208d01f 100644
--- a/docs/api/schemas/patchwork.j2
+++ b/docs/api/schemas/patchwork.j2
@@ -39,20 +39,20 @@ paths:
       - $ref: '#/components/parameters/Search'
       - in: query
         name: project
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: owner
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: public
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -77,8 +77,8 @@ paths:
       - in: path
         name: id
         required: true
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -109,20 +109,20 @@ paths:
       - $ref: '#/components/parameters/SinceFilter'
       - in: query
         name: project
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: series
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: submitter
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -146,9 +146,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -173,9 +173,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       - $ref: '#/components/parameters/Page'
@@ -215,14 +215,14 @@ paths:
       - $ref: '#/components/parameters/SinceFilter'
       - in: query
         name: project
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: category
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
           enum:
@@ -236,20 +236,20 @@ paths:
             - series-completed
       - in: query
         name: series
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: patch
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: cover
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -298,38 +298,38 @@ paths:
       - $ref: '#/components/parameters/SinceFilter'
       - in: query
         name: project
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: series
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: submitter
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: delegate
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: state
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: archived
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -353,13 +353,11 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
-      tags:
-      - patches
       responses:
         '200':
           description: ''
@@ -373,6 +371,8 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Error'
+      tags:
+      - patches
     patch:
       description: Update a patch (partial).
       operationId: patches_partial_update
@@ -382,9 +382,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       requestBody:
@@ -425,9 +425,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       requestBody:
@@ -466,9 +466,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       - $ref: '#/components/parameters/Page'
@@ -502,9 +502,9 @@ paths:
       parameters:
       - in: path
         name: patch_id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       - $ref: '#/components/parameters/Page'
@@ -515,20 +515,20 @@ paths:
       - $ref: '#/components/parameters/SinceFilter'
       - in: query
         name: user
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: state
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: context
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -560,9 +560,9 @@ paths:
       parameters:
       - in: path
         name: patch_id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       requestBody:
@@ -601,16 +601,16 @@ paths:
       parameters:
       - in: path
         name: patch_id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       - in: path
         name: check_id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -670,9 +670,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -726,9 +726,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -755,9 +755,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       requestBody:
@@ -798,9 +798,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       requestBody:
@@ -845,14 +845,14 @@ paths:
       - $ref: '#/components/parameters/SinceFilter'
       - in: query
         name: submitter
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: project
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -876,9 +876,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -938,9 +938,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: A unique integer value identifying this user.
         required: true
         schema:
-          description: A unique integer value identifying this user.
           title: ID
           type: integer
       responses:
@@ -973,9 +973,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: A unique integer value identifying this user.
         required: true
         schema:
-          description: A unique integer value identifying this user.
           title: ID
           type: integer
       requestBody:
@@ -1016,9 +1016,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: A unique integer value identifying this user.
         required: true
         schema:
-          description: A unique integer value identifying this user.
           title: ID
           type: integer
       requestBody:
@@ -1062,43 +1062,43 @@ components:
     Page:
       in: query
       name: page
+      description: A page number within the paginated result set.
       schema:
-        description: A page number within the paginated result set.
         title: Page
         type: integer
     PageSize:
       in: query
       name: per_page
+      description: Number of results to return per page.
       schema:
-        description: Number of results to return per page.
         title: Page size
         type: integer
     Order:
       in: query
       name: order
+      description: Which field to use when ordering the results.
       schema:
-        description: Which field to use when ordering the results.
         title: Ordering
         type: string
     Search:
       in: query
       name: q
+      description: A search term.
       schema:
-        description: A search term.
         title: Search
         type: string
     BeforeFilter:
       in: query
       name: before
+      description: ''
       schema:
-        description: ''
         title: ''
         type: string
     SinceFilter:
       in: query
       name: since
+      description: ''
       schema:
-        description: ''
         title: ''
         type: string
   headers:
diff --git a/docs/api/schemas/v1.0/patchwork.yaml b/docs/api/schemas/v1.0/patchwork.yaml
index 1fcdaea..e16fd4b 100644
--- a/docs/api/schemas/v1.0/patchwork.yaml
+++ b/docs/api/schemas/v1.0/patchwork.yaml
@@ -38,20 +38,20 @@ paths:
       - $ref: '#/components/parameters/Search'
       - in: query
         name: project
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: owner
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: public
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -76,8 +76,8 @@ paths:
       - in: path
         name: id
         required: true
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -108,20 +108,20 @@ paths:
       - $ref: '#/components/parameters/SinceFilter'
       - in: query
         name: project
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: series
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: submitter
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -145,9 +145,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -172,9 +172,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       - $ref: '#/components/parameters/Page'
@@ -214,14 +214,14 @@ paths:
       - $ref: '#/components/parameters/SinceFilter'
       - in: query
         name: project
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: category
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
           enum:
@@ -235,20 +235,20 @@ paths:
             - series-completed
       - in: query
         name: series
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: patch
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: cover
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -297,38 +297,38 @@ paths:
       - $ref: '#/components/parameters/SinceFilter'
       - in: query
         name: project
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: series
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: submitter
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: delegate
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: state
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: archived
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -352,13 +352,11 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
-      tags:
-      - patches
       responses:
         '200':
           description: ''
@@ -372,6 +370,8 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Error'
+      tags:
+      - patches
     patch:
       description: Update a patch (partial).
       operationId: patches_partial_update
@@ -381,9 +381,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       requestBody:
@@ -424,9 +424,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       requestBody:
@@ -465,9 +465,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       - $ref: '#/components/parameters/Page'
@@ -501,9 +501,9 @@ paths:
       parameters:
       - in: path
         name: patch_id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       - $ref: '#/components/parameters/Page'
@@ -514,20 +514,20 @@ paths:
       - $ref: '#/components/parameters/SinceFilter'
       - in: query
         name: user
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: state
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: context
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -559,9 +559,9 @@ paths:
       parameters:
       - in: path
         name: patch_id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       requestBody:
@@ -600,16 +600,16 @@ paths:
       parameters:
       - in: path
         name: patch_id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       - in: path
         name: check_id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -669,9 +669,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -725,9 +725,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -754,9 +754,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       requestBody:
@@ -797,9 +797,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       requestBody:
@@ -844,14 +844,14 @@ paths:
       - $ref: '#/components/parameters/SinceFilter'
       - in: query
         name: submitter
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: project
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -875,9 +875,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -937,9 +937,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: A unique integer value identifying this user.
         required: true
         schema:
-          description: A unique integer value identifying this user.
           title: ID
           type: integer
       responses:
@@ -972,9 +972,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: A unique integer value identifying this user.
         required: true
         schema:
-          description: A unique integer value identifying this user.
           title: ID
           type: integer
       requestBody:
@@ -1015,9 +1015,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: A unique integer value identifying this user.
         required: true
         schema:
-          description: A unique integer value identifying this user.
           title: ID
           type: integer
       requestBody:
@@ -1061,43 +1061,43 @@ components:
     Page:
       in: query
       name: page
+      description: A page number within the paginated result set.
       schema:
-        description: A page number within the paginated result set.
         title: Page
         type: integer
     PageSize:
       in: query
       name: per_page
+      description: Number of results to return per page.
       schema:
-        description: Number of results to return per page.
         title: Page size
         type: integer
     Order:
       in: query
       name: order
+      description: Which field to use when ordering the results.
       schema:
-        description: Which field to use when ordering the results.
         title: Ordering
         type: string
     Search:
       in: query
       name: q
+      description: A search term.
       schema:
-        description: A search term.
         title: Search
         type: string
     BeforeFilter:
       in: query
       name: before
+      description: ''
       schema:
-        description: ''
         title: ''
         type: string
     SinceFilter:
       in: query
       name: since
+      description: ''
       schema:
-        description: ''
         title: ''
         type: string
   headers:
diff --git a/docs/api/schemas/v1.1/patchwork.yaml b/docs/api/schemas/v1.1/patchwork.yaml
index 9415dc4..56cce53 100644
--- a/docs/api/schemas/v1.1/patchwork.yaml
+++ b/docs/api/schemas/v1.1/patchwork.yaml
@@ -38,20 +38,20 @@ paths:
       - $ref: '#/components/parameters/Search'
       - in: query
         name: project
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: owner
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: public
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -76,8 +76,8 @@ paths:
       - in: path
         name: id
         required: true
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -108,20 +108,20 @@ paths:
       - $ref: '#/components/parameters/SinceFilter'
       - in: query
         name: project
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: series
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: submitter
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -145,9 +145,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -172,9 +172,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       - $ref: '#/components/parameters/Page'
@@ -214,14 +214,14 @@ paths:
       - $ref: '#/components/parameters/SinceFilter'
       - in: query
         name: project
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: category
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
           enum:
@@ -235,20 +235,20 @@ paths:
             - series-completed
       - in: query
         name: series
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: patch
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: cover
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -297,38 +297,38 @@ paths:
       - $ref: '#/components/parameters/SinceFilter'
       - in: query
         name: project
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: series
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: submitter
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: delegate
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: state
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: archived
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -352,13 +352,11 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
-      tags:
-      - patches
       responses:
         '200':
           description: ''
@@ -372,6 +370,8 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Error'
+      tags:
+      - patches
     patch:
       description: Update a patch (partial).
       operationId: patches_partial_update
@@ -381,9 +381,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       requestBody:
@@ -424,9 +424,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       requestBody:
@@ -465,9 +465,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       - $ref: '#/components/parameters/Page'
@@ -501,9 +501,9 @@ paths:
       parameters:
       - in: path
         name: patch_id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       - $ref: '#/components/parameters/Page'
@@ -514,20 +514,20 @@ paths:
       - $ref: '#/components/parameters/SinceFilter'
       - in: query
         name: user
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: state
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: context
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -559,9 +559,9 @@ paths:
       parameters:
       - in: path
         name: patch_id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       requestBody:
@@ -600,16 +600,16 @@ paths:
       parameters:
       - in: path
         name: patch_id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       - in: path
         name: check_id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -669,9 +669,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -725,9 +725,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -754,9 +754,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       requestBody:
@@ -797,9 +797,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       requestBody:
@@ -844,14 +844,14 @@ paths:
       - $ref: '#/components/parameters/SinceFilter'
       - in: query
         name: submitter
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       - in: query
         name: project
+        description: ''
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -875,9 +875,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: ''
         required: true
         schema:
-          description: ''
           title: ''
           type: string
       responses:
@@ -937,9 +937,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: A unique integer value identifying this user.
         required: true
         schema:
-          description: A unique integer value identifying this user.
           title: ID
           type: integer
       responses:
@@ -972,9 +972,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: A unique integer value identifying this user.
         required: true
         schema:
-          description: A unique integer value identifying this user.
           title: ID
           type: integer
       requestBody:
@@ -1015,9 +1015,9 @@ paths:
       parameters:
       - in: path
         name: id
+        description: A unique integer value identifying this user.
         required: true
         schema:
-          description: A unique integer value identifying this user.
           title: ID
           type: integer
       requestBody:
@@ -1061,43 +1061,43 @@ components:
     Page:
       in: query
       name: page
+      description: A page number within the paginated result set.
       schema:
-        description: A page number within the paginated result set.
         title: Page
         type: integer
     PageSize:
       in: query
       name: per_page
+      description: Number of results to return per page.
       schema:
-        description: Number of results to return per page.
         title: Page size
         type: integer
     Order:
       in: query
       name: order
+      description: Which field to use when ordering the results.
       schema:
-        description: Which field to use when ordering the results.
         title: Ordering
         type: string
     Search:
       in: query
       name: q
+      description: A search term.
       schema:
-        description: A search term.
         title: Search
         type: string
     BeforeFilter:
       in: query
       name: before
+      description: ''
       schema:
-        description: ''
         title: ''
         type: string
     SinceFilter:
       in: query
       name: since
+      description: ''
       schema:
-        description: ''
         title: ''
         type: string
   headers: