Update OpenAPI descriptions

24 files changed, 298 insertions, 1299 deletions

diff --git a/descriptions/api.github.com/api.github.com.json b/descriptions/api.github.com/api.github.com.json
index a0f460fff..f3c96d2d0 100644
--- a/descriptions/api.github.com/api.github.com.json
+++ b/descriptions/api.github.com/api.github.com.json
@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "0.0.7",
+    "version": "1.0.0-rc.1",
     "title": "GitHub v3 REST API",
     "description": "GitHub's v3 REST API.",
     "license": {
@@ -394,7 +394,6 @@
         "parameters": [
           {
             "name": "code",
-            "description": "code parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -1410,13 +1409,7 @@
         },
         "parameters": [
           {
-            "name": "app_slug",
-            "description": "app_slug parameter",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
-            }
+            "$ref": "#/components/parameters/app_slug"
           }
         ],
         "responses": {
@@ -1793,7 +1786,6 @@
           },
           {
             "name": "fingerprint",
-            "description": "fingerprint parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -2176,7 +2168,6 @@
         "parameters": [
           {
             "name": "key",
-            "description": "key parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -2240,7 +2231,6 @@
         "parameters": [
           {
             "name": "content_reference_id",
-            "description": "content_reference_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -4803,7 +4793,6 @@
           },
           {
             "name": "sha",
-            "description": "sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -4916,7 +4905,6 @@
         "parameters": [
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -5298,7 +5286,6 @@
         "parameters": [
           {
             "name": "license",
-            "description": "license parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -8144,7 +8131,6 @@
           },
           {
             "name": "repository_id",
-            "description": "repository_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -8190,7 +8176,6 @@
           },
           {
             "name": "repository_id",
-            "description": "repository_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -8451,7 +8436,6 @@
           },
           {
             "name": "credential_id",
-            "description": "credential_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -16022,7 +16006,6 @@
           },
           {
             "name": "archive_format",
-            "description": "archive_format parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -16149,50 +16132,6 @@
         }
       }
     },
-    "/repos/{owner}/{repo}/actions/permissions": {
-      "get": {
-        "summary": "Get a repository's Actions permissions",
-        "description": "Gets the repository's permissions for running GitHub Actions. You must authenticate using an access token with the `admin:org` scope to use this endpoint. GitHub Apps must have the full `repo` permission to use this endpoint.",
-        "tags": [
-          "actions"
-        ],
-        "operationId": "actions/get-repo-permissions",
-        "parameters": [
-          {
-            "$ref": "#/components/parameters/owner"
-          },
-          {
-            "$ref": "#/components/parameters/repo"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "response",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/actions-repo-permissions"
-                },
-                "examples": {
-                  "default": {
-                    "$ref": "#/components/examples/actions-repo-permissions"
-                  }
-                }
-              }
-            }
-          }
-        },
-        "x-github": {
-          "githubCloudOnly": false,
-          "enabledForGitHubApps": true,
-          "previews": [
-
-          ],
-          "category": "actions",
-          "subcategory": "secrets"
-        }
-      }
-    },
     "/repos/{owner}/{repo}/actions/runners": {
       "get": {
         "summary": "List self-hosted runners for a repository",
@@ -16413,7 +16352,7 @@
     "/repos/{owner}/{repo}/actions/runners/{runner_id}": {
       "get": {
         "summary": "Get a self-hosted runner for a repository",
-        "description": "Gets a specific self-hosted runner configured in a repository.\n\nYou must authenticate using an access token with the `repo` scope to use this",
+        "description": "Gets a specific self-hosted runner configured in a repository.\n\nYou must authenticate using an access token with the `repo` scope to use this\nendpoint.",
         "tags": [
           "actions"
         ],
@@ -16462,7 +16401,7 @@
       },
       "delete": {
         "summary": "Delete a self-hosted runner from a repository",
-        "description": "Forces the removal of a self-hosted runner from a repository. You can use this endpoint to completely remove the runner when the machine you were using no longer exists.\n\nYou must authenticate using an access token with the `repo`",
+        "description": "Forces the removal of a self-hosted runner from a repository. You can use this endpoint to completely remove the runner when the machine you were using no longer exists.\n\nYou must authenticate using an access token with the `repo`\nscope to use this endpoint.",
         "tags": [
           "actions"
         ],
@@ -17725,7 +17664,6 @@
           },
           {
             "name": "assignee",
-            "description": "assignee parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -21291,7 +21229,6 @@
           },
           {
             "name": "alert_number",
-            "description": "alert_number parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -21556,7 +21493,7 @@
           "previews": [
 
           ],
-          "category": "code-scanning."
+          "category": "code-scanning"
         }
       }
     },
@@ -23283,7 +23220,6 @@
           },
           {
             "name": "base",
-            "description": "base parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -23292,7 +23228,6 @@
           },
           {
             "name": "head",
-            "description": "head parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -24466,7 +24401,6 @@
           },
           {
             "name": "status_id",
-            "description": "status_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -24542,10 +24476,13 @@
             "application/json": {
               "schema": {
                 "type": "object",
+                "required": [
+                  "event_type"
+                ],
                 "properties": {
                   "event_type": {
                     "type": "string",
-                    "description": "**Required:** A custom webhook event name."
+                    "description": "A custom webhook event name."
                   },
                   "client_payload": {
                     "type": "object",
@@ -24904,7 +24841,6 @@
           },
           {
             "name": "file_sha",
-            "description": "file_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -25649,7 +25585,6 @@
           },
           {
             "name": "tag_sha",
-            "description": "tag_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -25845,7 +25780,6 @@
           },
           {
             "name": "tree_sha",
-            "description": "tree_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -26775,7 +26709,6 @@
           },
           {
             "name": "author_id",
-            "description": "author_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -28255,7 +28188,6 @@
           },
           {
             "name": "event_id",
-            "description": "event_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -29209,7 +29141,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -30103,7 +30034,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -30161,7 +30091,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -30244,7 +30173,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -31165,6 +31093,7 @@
                 "properties": {
                   "source": {
                     "type": "object",
+                    "description": "The source branch and directory used to publish your Pages site.",
                     "properties": {
                       "branch": {
                         "type": "string",
@@ -31564,7 +31493,6 @@
           },
           {
             "name": "build_id",
-            "description": "build_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -35100,16 +35028,14 @@
             "in": "query",
             "schema": {
               "type": "string"
-            },
-            "description": "name parameter"
+            }
           },
           {
             "name": "label",
             "in": "query",
             "schema": {
               "type": "string"
-            },
-            "description": "label parameter"
+            }
           }
         ],
         "requestBody": {
@@ -35504,7 +35430,6 @@
           },
           {
             "name": "sha",
-            "description": "sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -35889,7 +35814,6 @@
           },
           {
             "name": "ref",
-            "description": "ref parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -36562,7 +36486,6 @@
           },
           {
             "name": "ref",
-            "description": "ref parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -36609,7 +36532,6 @@
         "parameters": [
           {
             "name": "template_owner",
-            "description": "template_owner parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -36618,7 +36540,6 @@
           },
           {
             "name": "template_repo",
-            "description": "template_repo parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -42961,13 +42882,7 @@
             "$ref": "#/components/parameters/installation_id"
           },
           {
-            "name": "repository_id",
-            "description": "repository_id parameter",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "integer"
-            }
+            "$ref": "#/components/parameters/repository_id"
           }
         ],
         "responses": {
@@ -43010,13 +42925,7 @@
             "$ref": "#/components/parameters/installation_id"
           },
           {
-            "name": "repository_id",
-            "description": "repository_id parameter",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "integer"
-            }
+            "$ref": "#/components/parameters/repository_id"
           }
         ],
         "responses": {
@@ -45671,7 +45580,6 @@
           },
           {
             "name": "target_user",
-            "description": "target_user parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -54534,23 +54442,6 @@
           "check_run_url"
         ]
       },
-      "actions-repo-permissions": {
-        "type": "object",
-        "properties": {
-          "enabled": {
-            "type": "boolean",
-            "description": "Whether GitHub Actions are allowed to run on this repo."
-          },
-          "allowed_actions": {
-            "type": "string",
-            "description": "Which GitHub Actions are allowed to run on this repo when enabled is true. Either 'all', 'local_only' or 'selected'."
-          },
-          "selected_actions_url": {
-            "type": "string",
-            "description": "The URL of the selected GitHub Actions that can run. Only when allowed_actions is selected."
-          }
-        }
-      },
       "pull-request-minimal": {
         "title": "Pull Request Minimal",
         "type": "object",
@@ -70977,19 +70868,6 @@
           "check_run_url": "https://api.github.com/repos/octo-org/octo-repo/check-runs/399444496"
         }
       },
-      "actions-repo-permissions": {
-        "value": [
-          {
-            "enabled": "true"
-          },
-          {
-            "allowed_actions": "selected"
-          },
-          {
-            "selected_actions_url": "https://api.github.com/repos/octo-org/octo-repo/actions/permissions/selected-actions"
-          }
-        ]
-      },
       "workflow-run-paginated": {
         "value": {
           "total_count": 1,
@@ -82765,6 +82643,14 @@
           "type": "string"
         }
       },
+      "app_slug": {
+        "name": "app_slug",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "type": "string"
+        }
+      },
       "authorization_id": {
         "name": "authorization_id",
         "description": "authorization_id parameter",
diff --git a/descriptions/api.github.com/api.github.com.yaml b/descriptions/api.github.com/api.github.com.yaml
index cd8846495..e524fc32b 100644
--- a/descriptions/api.github.com/api.github.com.yaml
+++ b/descriptions/api.github.com/api.github.com.yaml
@@ -1,7 +1,7 @@
 ---
 openapi: 3.0.3
 info:
-  version: 0.0.7
+  version: 1.0.0-rc.1
   title: GitHub v3 REST API
   description: GitHub's v3 REST API.
   license:
@@ -271,7 +271,6 @@ paths:
         url: https://developer.github.com/v3/apps/#create-a-github-app-from-a-manifest
       parameters:
       - name: code
-        description: code parameter
         in: path
         required: true
         schema:
@@ -993,12 +992,7 @@ paths:
         description: API method documentation
         url: https://developer.github.com/v3/apps/#get-an-app
       parameters:
-      - name: app_slug
-        description: app_slug parameter
-        in: path
-        required: true
-        schema:
-          type: string
+      - "$ref": "#/components/parameters/app_slug"
       responses:
         '200':
           description: response
@@ -1289,7 +1283,6 @@ paths:
       parameters:
       - "$ref": "#/components/parameters/client-id"
       - name: fingerprint
-        description: fingerprint parameter
         in: path
         required: true
         schema:
@@ -1568,7 +1561,6 @@ paths:
         url: https://developer.github.com/v3/codes_of_conduct/#get-a-code-of-conduct
       parameters:
       - name: key
-        description: key parameter
         in: path
         required: true
         schema:
@@ -1621,7 +1613,6 @@ paths:
         url: https://developer.github.com/v3/apps/installations/#create-a-content-attachment
       parameters:
       - name: content_reference_id
-        description: content_reference_id parameter
         in: path
         required: true
         schema:
@@ -3341,7 +3332,6 @@ paths:
       parameters:
       - "$ref": "#/components/parameters/gist_id"
       - name: sha
-        description: sha parameter
         in: path
         required: true
         schema:
@@ -3419,7 +3409,6 @@ paths:
         url: https://developer.github.com/v3/gitignore/#get-a-gitignore-template
       parameters:
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -3698,7 +3687,6 @@ paths:
         url: https://developer.github.com/v3/licenses/#get-a-license
       parameters:
       - name: license
-        description: license parameter
         in: path
         required: true
         schema:
@@ -5819,7 +5807,6 @@ paths:
       - "$ref": "#/components/parameters/org"
       - "$ref": "#/components/parameters/secret_name"
       - name: repository_id
-        description: repository_id parameter
         in: path
         required: true
         schema:
@@ -5853,7 +5840,6 @@ paths:
       - "$ref": "#/components/parameters/org"
       - "$ref": "#/components/parameters/secret_name"
       - name: repository_id
-        description: repository_id parameter
         in: path
         required: true
         schema:
@@ -6022,7 +6008,6 @@ paths:
       parameters:
       - "$ref": "#/components/parameters/org"
       - name: credential_id
-        description: credential_id parameter
         in: path
         required: true
         schema:
@@ -11557,7 +11542,6 @@ paths:
       - "$ref": "#/components/parameters/repo"
       - "$ref": "#/components/parameters/artifact_id"
       - name: archive_format
-        description: archive_format parameter
         in: path
         required: true
         schema:
@@ -11639,35 +11623,6 @@ paths:
         previews: []
         category: actions
         subcategory: workflow-jobs
-  "/repos/{owner}/{repo}/actions/permissions":
-    get:
-      summary: Get a repository's Actions permissions
-      description: Gets the repository's permissions for running GitHub Actions. You
-        must authenticate using an access token with the `admin:org` scope to use
-        this endpoint. GitHub Apps must have the full `repo` permission to use this
-        endpoint.
-      tags:
-      - actions
-      operationId: actions/get-repo-permissions
-      parameters:
-      - "$ref": "#/components/parameters/owner"
-      - "$ref": "#/components/parameters/repo"
-      responses:
-        '200':
-          description: response
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/actions-repo-permissions"
-              examples:
-                default:
-                  "$ref": "#/components/examples/actions-repo-permissions"
-      x-github:
-        githubCloudOnly: false
-        enabledForGitHubApps: true
-        previews: []
-        category: actions
-        subcategory: secrets
   "/repos/{owner}/{repo}/actions/runners":
     get:
       summary: List self-hosted runners for a repository
@@ -11819,6 +11774,7 @@ paths:
         Gets a specific self-hosted runner configured in a repository.
 
         You must authenticate using an access token with the `repo` scope to use this
+        endpoint.
       tags:
       - actions
       operationId: actions/get-self-hosted-runner-for-repo
@@ -11851,6 +11807,7 @@ paths:
         Forces the removal of a self-hosted runner from a repository. You can use this endpoint to completely remove the runner when the machine you were using no longer exists.
 
         You must authenticate using an access token with the `repo`
+        scope to use this endpoint.
       tags:
       - actions
       operationId: actions/delete-self-hosted-runner-from-repo
@@ -12746,7 +12703,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: assignee
-        description: assignee parameter
         in: path
         required: true
         schema:
@@ -15416,7 +15372,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: alert_number
-        description: alert_number parameter
         in: path
         required: true
         schema:
@@ -15597,7 +15552,7 @@ paths:
         enabledForApps: true
         githubCloudOnly: false
         previews: []
-        category: code-scanning.
+        category: code-scanning
   "/repos/{owner}/{repo}/collaborators":
     get:
       summary: List repository collaborators
@@ -16880,13 +16835,11 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: base
-        description: base parameter
         in: path
         required: true
         schema:
           type: string
       - name: head
-        description: head parameter
         in: path
         required: true
         schema:
@@ -17836,7 +17789,6 @@ paths:
       - "$ref": "#/components/parameters/repo"
       - "$ref": "#/components/parameters/deployment_id"
       - name: status_id
-        description: status_id parameter
         in: path
         required: true
         schema:
@@ -17904,10 +17856,12 @@ paths:
           application/json:
             schema:
               type: object
+              required:
+              - event_type
               properties:
                 event_type:
                   type: string
-                  description: "**Required:** A custom webhook event name."
+                  description: A custom webhook event name.
                 client_payload:
                   type: object
                   description: JSON payload with extra information about the webhook
@@ -18135,7 +18089,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: file_sha
-        description: file_sha parameter
         in: path
         required: true
         schema:
@@ -18765,7 +18718,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: tag_sha
-        description: tag_sha parameter
         in: path
         required: true
         schema:
@@ -18913,7 +18865,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: tree_sha
-        description: tree_sha parameter
         in: path
         required: true
         schema:
@@ -19583,7 +19534,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: author_id
-        description: author_id parameter
         in: path
         required: true
         schema:
@@ -20604,7 +20554,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: event_id
-        description: event_id parameter
         in: path
         required: true
         schema:
@@ -21250,7 +21199,6 @@ paths:
       - "$ref": "#/components/parameters/repo"
       - "$ref": "#/components/parameters/issue_number"
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -21854,7 +21802,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -21890,7 +21837,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -21948,7 +21894,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -22540,6 +22485,8 @@ paths:
               properties:
                 source:
                   type: object
+                  description: The source branch and directory used to publish your
+                    Pages site.
                   properties:
                     branch:
                       type: string
@@ -22809,7 +22756,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: build_id
-        description: build_id parameter
         in: path
         required: true
         schema:
@@ -25368,12 +25314,10 @@ paths:
         in: query
         schema:
           type: string
-        description: name parameter
       - name: label
         in: query
         schema:
           type: string
-        description: label parameter
       requestBody:
         content:
           "*/*":
@@ -25643,7 +25587,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: sha
-        description: sha parameter
         in: path
         required: true
         schema:
@@ -25899,7 +25842,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: ref
-        description: ref parameter
         in: path
         required: true
         schema:
@@ -26356,7 +26298,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: ref
-        description: ref parameter
         in: path
         required: true
         schema:
@@ -26395,13 +26336,11 @@ paths:
         url: https://developer.github.com/v3/repos/#create-a-repository-using-a-template
       parameters:
       - name: template_owner
-        description: template_owner parameter
         in: path
         required: true
         schema:
           type: string
       - name: template_repo
-        description: template_repo parameter
         in: path
         required: true
         schema:
@@ -31044,12 +30983,7 @@ paths:
         url: https://developer.github.com/v3/apps/installations/#add-a-repository-to-an-app-installation
       parameters:
       - "$ref": "#/components/parameters/installation_id"
-      - name: repository_id
-        description: repository_id parameter
-        in: path
-        required: true
-        schema:
-          type: integer
+      - "$ref": "#/components/parameters/repository_id"
       responses:
         '204':
           description: Empty response
@@ -31079,12 +31013,7 @@ paths:
         url: https://developer.github.com/v3/apps/installations/#remove-a-repository-from-an-app-installation
       parameters:
       - "$ref": "#/components/parameters/installation_id"
-      - name: repository_id
-        description: repository_id parameter
-        in: path
-        required: true
-        schema:
-          type: integer
+      - "$ref": "#/components/parameters/repository_id"
       responses:
         '204':
           description: Empty response
@@ -32936,7 +32865,6 @@ paths:
       parameters:
       - "$ref": "#/components/parameters/username"
       - name: target_user
-        description: target_user parameter
         in: path
         required: true
         schema:
@@ -39595,20 +39523,6 @@ components:
       - started_at
       - completed_at
       - check_run_url
-    actions-repo-permissions:
-      type: object
-      properties:
-        enabled:
-          type: boolean
-          description: Whether GitHub Actions are allowed to run on this repo.
-        allowed_actions:
-          type: string
-          description: Which GitHub Actions are allowed to run on this repo when enabled
-            is true. Either 'all', 'local_only' or 'selected'.
-        selected_actions_url:
-          type: string
-          description: The URL of the selected GitHub Actions that can run. Only when
-            allowed_actions is selected.
     pull-request-minimal:
       title: Pull Request Minimal
       type: object
@@ -52662,11 +52576,6 @@ components:
           started_at: '2020-01-20T09:44:39.000-08:00'
           completed_at: '2020-01-20T09:44:39.000-08:00'
         check_run_url: https://api.github.com/repos/octo-org/octo-repo/check-runs/399444496
-    actions-repo-permissions:
-      value:
-      - enabled: 'true'
-      - allowed_actions: selected
-      - selected_actions_url: https://api.github.com/repos/octo-org/octo-repo/actions/permissions/selected-actions
     workflow-run-paginated:
       value:
         total_count: 1
@@ -62838,6 +62747,12 @@ components:
       required: true
       schema:
         type: string
+    app_slug:
+      name: app_slug
+      in: path
+      required: true
+      schema:
+        type: string
     authorization_id:
       name: authorization_id
       description: authorization_id parameter
diff --git a/descriptions/api.github.com/dereferenced/api.github.com.deref.json b/descriptions/api.github.com/dereferenced/api.github.com.deref.json
index 22ae3fbfa..8f47585e1 100644
--- a/descriptions/api.github.com/dereferenced/api.github.com.deref.json
+++ b/descriptions/api.github.com/dereferenced/api.github.com.deref.json
@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "0.0.7",
+    "version": "1.0.0-rc.1",
     "title": "GitHub v3 REST API",
     "description": "GitHub's v3 REST API.",
     "license": {
@@ -673,7 +673,6 @@
         "parameters": [
           {
             "name": "code",
-            "description": "code parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -6905,7 +6904,6 @@
         "parameters": [
           {
             "name": "app_slug",
-            "description": "app_slug parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -9474,7 +9472,6 @@
           },
           {
             "name": "fingerprint",
-            "description": "fingerprint parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -11699,7 +11696,6 @@
         "parameters": [
           {
             "name": "key",
-            "description": "key parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -11837,7 +11833,6 @@
         "parameters": [
           {
             "name": "content_reference_id",
-            "description": "content_reference_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -26571,7 +26566,6 @@
           },
           {
             "name": "sha",
-            "description": "sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -27432,7 +27426,6 @@
         "parameters": [
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -31587,7 +31580,6 @@
         "parameters": [
           {
             "name": "license",
-            "description": "license parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -46363,7 +46355,6 @@
           },
           {
             "name": "repository_id",
-            "description": "repository_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -46420,7 +46411,6 @@
           },
           {
             "name": "repository_id",
-            "description": "repository_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -47032,7 +47022,6 @@
           },
           {
             "name": "credential_id",
-            "description": "credential_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -91620,7 +91609,6 @@
           },
           {
             "name": "archive_format",
-            "description": "archive_format parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -92021,84 +92009,6 @@
         }
       }
     },
-    "/repos/{owner}/{repo}/actions/permissions": {
-      "get": {
-        "summary": "Get a repository's Actions permissions",
-        "description": "Gets the repository's permissions for running GitHub Actions. You must authenticate using an access token with the `admin:org` scope to use this endpoint. GitHub Apps must have the full `repo` permission to use this endpoint.",
-        "tags": [
-          "actions"
-        ],
-        "operationId": "actions/get-repo-permissions",
-        "parameters": [
-          {
-            "name": "owner",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
-            }
-          },
-          {
-            "name": "repo",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "response",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "enabled": {
-                      "type": "boolean",
-                      "description": "Whether GitHub Actions are allowed to run on this repo."
-                    },
-                    "allowed_actions": {
-                      "type": "string",
-                      "description": "Which GitHub Actions are allowed to run on this repo when enabled is true. Either 'all', 'local_only' or 'selected'."
-                    },
-                    "selected_actions_url": {
-                      "type": "string",
-                      "description": "The URL of the selected GitHub Actions that can run. Only when allowed_actions is selected."
-                    }
-                  }
-                },
-                "examples": {
-                  "default": {
-                    "value": [
-                      {
-                        "enabled": "true"
-                      },
-                      {
-                        "allowed_actions": "selected"
-                      },
-                      {
-                        "selected_actions_url": "https://api.github.com/repos/octo-org/octo-repo/actions/permissions/selected-actions"
-                      }
-                    ]
-                  }
-                }
-              }
-            }
-          }
-        },
-        "x-github": {
-          "githubCloudOnly": false,
-          "enabledForGitHubApps": true,
-          "previews": [
-
-          ],
-          "category": "actions",
-          "subcategory": "secrets"
-        }
-      }
-    },
     "/repos/{owner}/{repo}/actions/runners": {
       "get": {
         "summary": "List self-hosted runners for a repository",
@@ -94559,7 +94469,7 @@
     "/repos/{owner}/{repo}/actions/runners/{runner_id}": {
       "get": {
         "summary": "Get a self-hosted runner for a repository",
-        "description": "Gets a specific self-hosted runner configured in a repository.\n\nYou must authenticate using an access token with the `repo` scope to use this",
+        "description": "Gets a specific self-hosted runner configured in a repository.\n\nYou must authenticate using an access token with the `repo` scope to use this\nendpoint.",
         "tags": [
           "actions"
         ],
@@ -94711,7 +94621,7 @@
       },
       "delete": {
         "summary": "Delete a self-hosted runner from a repository",
-        "description": "Forces the removal of a self-hosted runner from a repository. You can use this endpoint to completely remove the runner when the machine you were using no longer exists.\n\nYou must authenticate using an access token with the `repo`",
+        "description": "Forces the removal of a self-hosted runner from a repository. You can use this endpoint to completely remove the runner when the machine you were using no longer exists.\n\nYou must authenticate using an access token with the `repo`\nscope to use this endpoint.",
         "tags": [
           "actions"
         ],
@@ -101832,7 +101742,6 @@
           },
           {
             "name": "assignee",
-            "description": "assignee parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -120848,7 +120757,6 @@
           },
           {
             "name": "alert_number",
-            "description": "alert_number parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -121890,7 +121798,7 @@
           "previews": [
 
           ],
-          "category": "code-scanning."
+          "category": "code-scanning"
         }
       }
     },
@@ -135308,7 +135216,6 @@
           },
           {
             "name": "base",
-            "description": "base parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -135317,7 +135224,6 @@
           },
           {
             "name": "head",
-            "description": "head parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -142821,7 +142727,6 @@
           },
           {
             "name": "status_id",
-            "description": "status_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -143439,10 +143344,13 @@
             "application/json": {
               "schema": {
                 "type": "object",
+                "required": [
+                  "event_type"
+                ],
                 "properties": {
                   "event_type": {
                     "type": "string",
-                    "description": "**Required:** A custom webhook event name."
+                    "description": "A custom webhook event name."
                   },
                   "client_payload": {
                     "type": "object",
@@ -148602,7 +148510,6 @@
           },
           {
             "name": "file_sha",
-            "description": "file_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -150609,7 +150516,6 @@
           },
           {
             "name": "tag_sha",
-            "description": "tag_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -151171,7 +151077,6 @@
           },
           {
             "name": "tree_sha",
-            "description": "tree_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -154056,7 +153961,6 @@
           },
           {
             "name": "author_id",
-            "description": "author_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -168747,7 +168651,6 @@
           },
           {
             "name": "event_id",
-            "description": "event_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -183890,7 +183793,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -186444,7 +186346,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -186582,7 +186483,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -186728,7 +186628,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -190637,6 +190536,7 @@
                 "properties": {
                   "source": {
                     "type": "object",
+                    "description": "The source branch and directory used to publish your Pages site.",
                     "properties": {
                       "branch": {
                         "type": "string",
@@ -191913,7 +191813,6 @@
           },
           {
             "name": "build_id",
-            "description": "build_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -224337,16 +224236,14 @@
             "in": "query",
             "schema": {
               "type": "string"
-            },
-            "description": "name parameter"
+            }
           },
           {
             "name": "label",
             "in": "query",
             "schema": {
               "type": "string"
-            },
-            "description": "label parameter"
+            }
           }
         ],
         "requestBody": {
@@ -225803,7 +225700,6 @@
           },
           {
             "name": "sha",
-            "description": "sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -226752,7 +226648,6 @@
           },
           {
             "name": "ref",
-            "description": "ref parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -229390,7 +229285,6 @@
           },
           {
             "name": "ref",
-            "description": "ref parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -229437,7 +229331,6 @@
         "parameters": [
           {
             "name": "template_owner",
-            "description": "template_owner parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -229446,7 +229339,6 @@
           },
           {
             "name": "template_repo",
-            "description": "template_repo parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -260048,7 +259940,6 @@
           },
           {
             "name": "repository_id",
-            "description": "repository_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -260137,7 +260028,6 @@
           },
           {
             "name": "repository_id",
-            "description": "repository_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -288840,7 +288730,6 @@
           },
           {
             "name": "target_user",
-            "description": "target_user parameter",
             "in": "path",
             "required": true,
             "schema": {
diff --git a/descriptions/api.github.com/dereferenced/api.github.com.deref.yaml b/descriptions/api.github.com/dereferenced/api.github.com.deref.yaml
index 303fa24c0..d159d9332 100644
--- a/descriptions/api.github.com/dereferenced/api.github.com.deref.yaml
+++ b/descriptions/api.github.com/dereferenced/api.github.com.deref.yaml
@@ -1,7 +1,7 @@
 ---
 openapi: 3.0.3
 info:
-  version: 0.0.7
+  version: 1.0.0-rc.1
   title: GitHub v3 REST API
   description: GitHub's v3 REST API.
   license:
@@ -499,7 +499,6 @@ paths:
         url: https://developer.github.com/v3/apps/#create-a-github-app-from-a-manifest
       parameters:
       - name: code
-        description: code parameter
         in: path
         required: true
         schema:
@@ -5274,7 +5273,6 @@ paths:
         url: https://developer.github.com/v3/apps/#get-an-app
       parameters:
       - name: app_slug
-        description: app_slug parameter
         in: path
         required: true
         schema:
@@ -7258,7 +7256,6 @@ paths:
         schema:
           type: string
       - name: fingerprint
-        description: fingerprint parameter
         in: path
         required: true
         schema:
@@ -9007,7 +9004,6 @@ paths:
         url: https://developer.github.com/v3/codes_of_conduct/#get-a-code-of-conduct
       parameters:
       - name: key
-        description: key parameter
         in: path
         required: true
         schema:
@@ -9209,7 +9205,6 @@ paths:
         url: https://developer.github.com/v3/apps/installations/#create-a-content-attachment
       parameters:
       - name: content_reference_id
-        description: content_reference_id parameter
         in: path
         required: true
         schema:
@@ -20094,7 +20089,6 @@ paths:
         schema:
           type: string
       - name: sha
-        description: sha parameter
         in: path
         required: true
         schema:
@@ -20703,7 +20697,6 @@ paths:
         url: https://developer.github.com/v3/gitignore/#get-a-gitignore-template
       parameters:
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -23965,7 +23958,6 @@ paths:
         url: https://developer.github.com/v3/licenses/#get-a-license
       parameters:
       - name: license
-        description: license parameter
         in: path
         required: true
         schema:
@@ -35314,7 +35306,6 @@ paths:
         schema:
           type: string
       - name: repository_id
-        description: repository_id parameter
         in: path
         required: true
         schema:
@@ -35357,7 +35348,6 @@ paths:
         schema:
           type: string
       - name: repository_id
-        description: repository_id parameter
         in: path
         required: true
         schema:
@@ -35793,7 +35783,6 @@ paths:
         schema:
           type: string
       - name: credential_id
-        description: credential_id parameter
         in: path
         required: true
         schema:
@@ -70284,7 +70273,6 @@ paths:
         schema:
           type: integer
       - name: archive_format
-        description: archive_format parameter
         in: path
         required: true
         schema:
@@ -70588,59 +70576,6 @@ paths:
         previews: []
         category: actions
         subcategory: workflow-jobs
-  "/repos/{owner}/{repo}/actions/permissions":
-    get:
-      summary: Get a repository's Actions permissions
-      description: Gets the repository's permissions for running GitHub Actions. You
-        must authenticate using an access token with the `admin:org` scope to use
-        this endpoint. GitHub Apps must have the full `repo` permission to use this
-        endpoint.
-      tags:
-      - actions
-      operationId: actions/get-repo-permissions
-      parameters:
-      - name: owner
-        in: path
-        required: true
-        schema:
-          type: string
-      - name: repo
-        in: path
-        required: true
-        schema:
-          type: string
-      responses:
-        '200':
-          description: response
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  enabled:
-                    type: boolean
-                    description: Whether GitHub Actions are allowed to run on this
-                      repo.
-                  allowed_actions:
-                    type: string
-                    description: Which GitHub Actions are allowed to run on this repo
-                      when enabled is true. Either 'all', 'local_only' or 'selected'.
-                  selected_actions_url:
-                    type: string
-                    description: The URL of the selected GitHub Actions that can run.
-                      Only when allowed_actions is selected.
-              examples:
-                default:
-                  value:
-                  - enabled: 'true'
-                  - allowed_actions: selected
-                  - selected_actions_url: https://api.github.com/repos/octo-org/octo-repo/actions/permissions/selected-actions
-      x-github:
-        githubCloudOnly: false
-        enabledForGitHubApps: true
-        previews: []
-        category: actions
-        subcategory: secrets
   "/repos/{owner}/{repo}/actions/runners":
     get:
       summary: List self-hosted runners for a repository
@@ -72479,6 +72414,7 @@ paths:
         Gets a specific self-hosted runner configured in a repository.
 
         You must authenticate using an access token with the `repo` scope to use this
+        endpoint.
       tags:
       - actions
       operationId: actions/get-self-hosted-runner-for-repo
@@ -72588,6 +72524,7 @@ paths:
         Forces the removal of a self-hosted runner from a repository. You can use this endpoint to completely remove the runner when the machine you were using no longer exists.
 
         You must authenticate using an access token with the `repo`
+        scope to use this endpoint.
       tags:
       - actions
       operationId: actions/delete-self-hosted-runner-from-repo
@@ -78120,7 +78057,6 @@ paths:
         schema:
           type: string
       - name: assignee
-        description: assignee parameter
         in: path
         required: true
         schema:
@@ -92665,7 +92601,6 @@ paths:
         schema:
           type: string
       - name: alert_number
-        description: alert_number parameter
         in: path
         required: true
         schema:
@@ -93481,7 +93416,7 @@ paths:
         enabledForApps: true
         githubCloudOnly: false
         previews: []
-        category: code-scanning.
+        category: code-scanning
   "/repos/{owner}/{repo}/collaborators":
     get:
       summary: List repository collaborators
@@ -104002,13 +103937,11 @@ paths:
         schema:
           type: string
       - name: base
-        description: base parameter
         in: path
         required: true
         schema:
           type: string
       - name: head
-        description: head parameter
         in: path
         required: true
         schema:
@@ -109838,7 +109771,6 @@ paths:
         schema:
           type: integer
       - name: status_id
-        description: status_id parameter
         in: path
         required: true
         schema:
@@ -110340,10 +110272,12 @@ paths:
           application/json:
             schema:
               type: object
+              required:
+              - event_type
               properties:
                 event_type:
                   type: string
-                  description: "**Required:** A custom webhook event name."
+                  description: A custom webhook event name.
                 client_payload:
                   type: object
                   description: JSON payload with extra information about the webhook
@@ -114268,7 +114202,6 @@ paths:
         schema:
           type: string
       - name: file_sha
-        description: file_sha parameter
         in: path
         required: true
         schema:
@@ -115786,7 +115719,6 @@ paths:
         schema:
           type: string
       - name: tag_sha
-        description: tag_sha parameter
         in: path
         required: true
         schema:
@@ -116194,7 +116126,6 @@ paths:
         schema:
           type: string
       - name: tree_sha
-        description: tree_sha parameter
         in: path
         required: true
         schema:
@@ -118326,7 +118257,6 @@ paths:
         schema:
           type: string
       - name: author_id
-        description: author_id parameter
         in: path
         required: true
         schema:
@@ -129665,7 +129595,6 @@ paths:
         schema:
           type: string
       - name: event_id
-        description: event_id parameter
         in: path
         required: true
         schema:
@@ -141373,7 +141302,6 @@ paths:
         schema:
           type: integer
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -143217,7 +143145,6 @@ paths:
         schema:
           type: string
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -143317,7 +143244,6 @@ paths:
         schema:
           type: string
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -143428,7 +143354,6 @@ paths:
         schema:
           type: string
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -146396,6 +146321,8 @@ paths:
               properties:
                 source:
                   type: object
+                  description: The source branch and directory used to publish your
+                    Pages site.
                   properties:
                     branch:
                       type: string
@@ -147309,7 +147236,6 @@ paths:
         schema:
           type: string
       - name: build_id
-        description: build_id parameter
         in: path
         required: true
         schema:
@@ -172748,12 +172674,10 @@ paths:
         in: query
         schema:
           type: string
-        description: name parameter
       - name: label
         in: query
         schema:
           type: string
-        description: label parameter
       requestBody:
         content:
           "*/*":
@@ -173864,7 +173788,6 @@ paths:
         schema:
           type: string
       - name: sha
-        description: sha parameter
         in: path
         required: true
         schema:
@@ -174576,7 +174499,6 @@ paths:
         schema:
           type: string
       - name: ref
-        description: ref parameter
         in: path
         required: true
         schema:
@@ -176501,7 +176423,6 @@ paths:
         schema:
           type: string
       - name: ref
-        description: ref parameter
         in: path
         required: true
         schema:
@@ -176540,13 +176461,11 @@ paths:
         url: https://developer.github.com/v3/repos/#create-a-repository-using-a-template
       parameters:
       - name: template_owner
-        description: template_owner parameter
         in: path
         required: true
         schema:
           type: string
       - name: template_repo
-        description: template_repo parameter
         in: path
         required: true
         schema:
@@ -199614,7 +199533,6 @@ paths:
         schema:
           type: integer
       - name: repository_id
-        description: repository_id parameter
         in: path
         required: true
         schema:
@@ -199676,7 +199594,6 @@ paths:
         schema:
           type: integer
       - name: repository_id
-        description: repository_id parameter
         in: path
         required: true
         schema:
@@ -221745,7 +221662,6 @@ paths:
         schema:
           type: string
       - name: target_user
-        description: target_user parameter
         in: path
         required: true
         schema:
diff --git a/descriptions/ghes-2.18/dereferenced/ghes-2.18.deref.json b/descriptions/ghes-2.18/dereferenced/ghes-2.18.deref.json
index aa50188d6..eccbb4809 100644
--- a/descriptions/ghes-2.18/dereferenced/ghes-2.18.deref.json
+++ b/descriptions/ghes-2.18/dereferenced/ghes-2.18.deref.json
@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "0.0.7",
+    "version": "1.0.0-rc.1",
     "title": "GitHub v3 REST API",
     "description": "GitHub's v3 REST API.",
     "license": {
@@ -5156,7 +5156,6 @@
         "parameters": [
           {
             "name": "code",
-            "description": "code parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -9355,7 +9354,6 @@
         "parameters": [
           {
             "name": "app_slug",
-            "description": "app_slug parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -11924,7 +11922,6 @@
           },
           {
             "name": "fingerprint",
-            "description": "fingerprint parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -14149,7 +14146,6 @@
         "parameters": [
           {
             "name": "key",
-            "description": "key parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -14287,7 +14283,6 @@
         "parameters": [
           {
             "name": "content_reference_id",
-            "description": "content_reference_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -25232,7 +25227,6 @@
           },
           {
             "name": "sha",
-            "description": "sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -26093,7 +26087,6 @@
         "parameters": [
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -30217,7 +30210,6 @@
         "parameters": [
           {
             "name": "license",
-            "description": "license parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -64822,7 +64814,6 @@
           },
           {
             "name": "assignee",
-            "description": "assignee parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -94660,7 +94651,6 @@
           },
           {
             "name": "base",
-            "description": "base parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -94669,7 +94659,6 @@
           },
           {
             "name": "head",
-            "description": "head parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -102070,7 +102059,6 @@
           },
           {
             "name": "status_id",
-            "description": "status_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -107709,7 +107697,6 @@
           },
           {
             "name": "file_sha",
-            "description": "file_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -109544,7 +109531,6 @@
           },
           {
             "name": "tag_sha",
-            "description": "tag_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -110106,7 +110092,6 @@
           },
           {
             "name": "tree_sha",
-            "description": "tree_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -125707,7 +125692,6 @@
           },
           {
             "name": "event_id",
-            "description": "event_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -140850,7 +140834,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -143337,7 +143320,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -143475,7 +143457,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -147384,6 +147365,7 @@
                 "properties": {
                   "source": {
                     "type": "object",
+                    "description": "The source branch and directory used to publish your Pages site.",
                     "properties": {
                       "branch": {
                         "type": "string",
@@ -148660,7 +148642,6 @@
           },
           {
             "name": "build_id",
-            "description": "build_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -181014,16 +180995,14 @@
             "in": "query",
             "schema": {
               "type": "string"
-            },
-            "description": "name parameter"
+            }
           },
           {
             "name": "label",
             "in": "query",
             "schema": {
               "type": "string"
-            },
-            "description": "label parameter"
+            }
           }
         ],
         "requestBody": {
@@ -182480,7 +182459,6 @@
           },
           {
             "name": "sha",
-            "description": "sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -183429,7 +183407,6 @@
           },
           {
             "name": "ref",
-            "description": "ref parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -185299,7 +185276,6 @@
           },
           {
             "name": "ref",
-            "description": "ref parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -185346,7 +185322,6 @@
         "parameters": [
           {
             "name": "template_owner",
-            "description": "template_owner parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -185355,7 +185330,6 @@
           },
           {
             "name": "template_repo",
-            "description": "template_repo parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -213155,7 +213129,6 @@
           },
           {
             "name": "repository_id",
-            "description": "repository_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -213244,7 +213217,6 @@
           },
           {
             "name": "repository_id",
-            "description": "repository_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -235940,7 +235912,6 @@
           },
           {
             "name": "target_user",
-            "description": "target_user parameter",
             "in": "path",
             "required": true,
             "schema": {
diff --git a/descriptions/ghes-2.18/dereferenced/ghes-2.18.deref.yaml b/descriptions/ghes-2.18/dereferenced/ghes-2.18.deref.yaml
index 6b6f63898..fa2d2d6a2 100644
--- a/descriptions/ghes-2.18/dereferenced/ghes-2.18.deref.yaml
+++ b/descriptions/ghes-2.18/dereferenced/ghes-2.18.deref.yaml
@@ -1,7 +1,7 @@
 ---
 openapi: 3.0.3
 info:
-  version: 0.0.7
+  version: 1.0.0-rc.1
   title: GitHub v3 REST API
   description: GitHub's v3 REST API.
   license:
@@ -3828,7 +3828,6 @@ paths:
         url: https://developer.github.com/enterprise/2.18/v3/apps/#create-a-github-app-from-a-manifest
       parameters:
       - name: code
-        description: code parameter
         in: path
         required: true
         schema:
@@ -7033,7 +7032,6 @@ paths:
         url: https://developer.github.com/enterprise/2.18/v3/apps/#get-an-app
       parameters:
       - name: app_slug
-        description: app_slug parameter
         in: path
         required: true
         schema:
@@ -9017,7 +9015,6 @@ paths:
         schema:
           type: string
       - name: fingerprint
-        description: fingerprint parameter
         in: path
         required: true
         schema:
@@ -10766,7 +10763,6 @@ paths:
         url: https://developer.github.com/enterprise/2.18/v3/codes_of_conduct/#get-a-code-of-conduct
       parameters:
       - name: key
-        description: key parameter
         in: path
         required: true
         schema:
@@ -10968,7 +10964,6 @@ paths:
         url: https://developer.github.com/enterprise/2.18/v3/apps/installations/#create-a-content-attachment
       parameters:
       - name: content_reference_id
-        description: content_reference_id parameter
         in: path
         required: true
         schema:
@@ -19040,7 +19035,6 @@ paths:
         schema:
           type: string
       - name: sha
-        description: sha parameter
         in: path
         required: true
         schema:
@@ -19649,7 +19643,6 @@ paths:
         url: https://developer.github.com/enterprise/2.18/v3/gitignore/#get-a-gitignore-template
       parameters:
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -22886,7 +22879,6 @@ paths:
         url: https://developer.github.com/enterprise/2.18/v3/licenses/#get-a-license
       parameters:
       - name: license
-        description: license parameter
         in: path
         required: true
         schema:
@@ -49539,7 +49531,6 @@ paths:
         schema:
           type: string
       - name: assignee
-        description: assignee parameter
         in: path
         required: true
         schema:
@@ -72612,13 +72603,11 @@ paths:
         schema:
           type: string
       - name: base
-        description: base parameter
         in: path
         required: true
         schema:
           type: string
       - name: head
-        description: head parameter
         in: path
         required: true
         schema:
@@ -78372,7 +78361,6 @@ paths:
         schema:
           type: integer
       - name: status_id
-        description: status_id parameter
         in: path
         required: true
         schema:
@@ -82703,7 +82691,6 @@ paths:
         schema:
           type: string
       - name: file_sha
-        description: file_sha parameter
         in: path
         required: true
         schema:
@@ -84108,7 +84095,6 @@ paths:
         schema:
           type: string
       - name: tag_sha
-        description: tag_sha parameter
         in: path
         required: true
         schema:
@@ -84516,7 +84502,6 @@ paths:
         schema:
           type: string
       - name: tree_sha
-        description: tree_sha parameter
         in: path
         required: true
         schema:
@@ -96526,7 +96511,6 @@ paths:
         schema:
           type: string
       - name: event_id
-        description: event_id parameter
         in: path
         required: true
         schema:
@@ -108234,7 +108218,6 @@ paths:
         schema:
           type: integer
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -110024,7 +110007,6 @@ paths:
         schema:
           type: string
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -110124,7 +110106,6 @@ paths:
         schema:
           type: string
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -113092,6 +113073,8 @@ paths:
               properties:
                 source:
                   type: object
+                  description: The source branch and directory used to publish your
+                    Pages site.
                   properties:
                     branch:
                       type: string
@@ -114005,7 +113988,6 @@ paths:
         schema:
           type: string
       - name: build_id
-        description: build_id parameter
         in: path
         required: true
         schema:
@@ -139306,12 +139288,10 @@ paths:
         in: query
         schema:
           type: string
-        description: name parameter
       - name: label
         in: query
         schema:
           type: string
-        description: label parameter
       requestBody:
         content:
           "*/*":
@@ -140422,7 +140402,6 @@ paths:
         schema:
           type: string
       - name: sha
-        description: sha parameter
         in: path
         required: true
         schema:
@@ -141134,7 +141113,6 @@ paths:
         schema:
           type: string
       - name: ref
-        description: ref parameter
         in: path
         required: true
         schema:
@@ -142547,7 +142525,6 @@ paths:
         schema:
           type: string
       - name: ref
-        description: ref parameter
         in: path
         required: true
         schema:
@@ -142586,13 +142563,11 @@ paths:
         url: https://developer.github.com/enterprise/2.18/v3/repos/#create-a-repository-using-a-template
       parameters:
       - name: template_owner
-        description: template_owner parameter
         in: path
         required: true
         schema:
           type: string
       - name: template_repo
-        description: template_repo parameter
         in: path
         required: true
         schema:
@@ -164011,7 +163986,6 @@ paths:
         schema:
           type: integer
       - name: repository_id
-        description: repository_id parameter
         in: path
         required: true
         schema:
@@ -164073,7 +164047,6 @@ paths:
         schema:
           type: integer
       - name: repository_id
-        description: repository_id parameter
         in: path
         required: true
         schema:
@@ -181495,7 +181468,6 @@ paths:
         schema:
           type: string
       - name: target_user
-        description: target_user parameter
         in: path
         required: true
         schema:
diff --git a/descriptions/ghes-2.18/ghes-2.18.json b/descriptions/ghes-2.18/ghes-2.18.json
index 7c125b5b3..4a27f20e1 100644
--- a/descriptions/ghes-2.18/ghes-2.18.json
+++ b/descriptions/ghes-2.18/ghes-2.18.json
@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "0.0.7",
+    "version": "1.0.0-rc.1",
     "title": "GitHub v3 REST API",
     "description": "GitHub's v3 REST API.",
     "license": {
@@ -2518,7 +2518,6 @@
         "parameters": [
           {
             "name": "code",
-            "description": "code parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -3205,13 +3204,7 @@
         },
         "parameters": [
           {
-            "name": "app_slug",
-            "description": "app_slug parameter",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
-            }
+            "$ref": "#/components/parameters/app_slug"
           }
         ],
         "responses": {
@@ -3588,7 +3581,6 @@
           },
           {
             "name": "fingerprint",
-            "description": "fingerprint parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -3971,7 +3963,6 @@
         "parameters": [
           {
             "name": "key",
-            "description": "key parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -4035,7 +4026,6 @@
         "parameters": [
           {
             "name": "content_reference_id",
-            "description": "content_reference_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -5540,7 +5530,6 @@
           },
           {
             "name": "sha",
-            "description": "sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -5653,7 +5642,6 @@
         "parameters": [
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -6004,7 +5992,6 @@
         "parameters": [
           {
             "name": "license",
-            "description": "license parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -11412,7 +11399,6 @@
           },
           {
             "name": "assignee",
-            "description": "assignee parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -16165,7 +16151,6 @@
           },
           {
             "name": "base",
-            "description": "base parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -16174,7 +16159,6 @@
           },
           {
             "name": "head",
-            "description": "head parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -17305,7 +17289,6 @@
           },
           {
             "name": "status_id",
-            "description": "status_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -17677,7 +17660,6 @@
           },
           {
             "name": "file_sha",
-            "description": "file_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -18343,7 +18325,6 @@
           },
           {
             "name": "tag_sha",
-            "description": "tag_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -18539,7 +18520,6 @@
           },
           {
             "name": "tree_sha",
-            "description": "tree_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -20184,7 +20164,6 @@
           },
           {
             "name": "event_id",
-            "description": "event_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -21138,7 +21117,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -21986,7 +21964,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -22044,7 +22021,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -22965,6 +22941,7 @@
                 "properties": {
                   "source": {
                     "type": "object",
+                    "description": "The source branch and directory used to publish your Pages site.",
                     "properties": {
                       "branch": {
                         "type": "string",
@@ -23364,7 +23341,6 @@
           },
           {
             "name": "build_id",
-            "description": "build_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -27025,16 +27001,14 @@
             "in": "query",
             "schema": {
               "type": "string"
-            },
-            "description": "name parameter"
+            }
           },
           {
             "name": "label",
             "in": "query",
             "schema": {
               "type": "string"
-            },
-            "description": "label parameter"
+            }
           }
         ],
         "requestBody": {
@@ -27429,7 +27403,6 @@
           },
           {
             "name": "sha",
-            "description": "sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -27814,7 +27787,6 @@
           },
           {
             "name": "ref",
-            "description": "ref parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -28230,7 +28202,6 @@
           },
           {
             "name": "ref",
-            "description": "ref parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -28277,7 +28248,6 @@
         "parameters": [
           {
             "name": "template_owner",
-            "description": "template_owner parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -28286,7 +28256,6 @@
           },
           {
             "name": "template_repo",
-            "description": "template_repo parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -33193,13 +33162,7 @@
             "$ref": "#/components/parameters/installation_id"
           },
           {
-            "name": "repository_id",
-            "description": "repository_id parameter",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "integer"
-            }
+            "$ref": "#/components/parameters/repository_id"
           }
         ],
         "responses": {
@@ -33242,13 +33205,7 @@
             "$ref": "#/components/parameters/installation_id"
           },
           {
-            "name": "repository_id",
-            "description": "repository_id parameter",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "integer"
-            }
+            "$ref": "#/components/parameters/repository_id"
           }
         ],
         "responses": {
@@ -35321,7 +35278,6 @@
           },
           {
             "name": "target_user",
-            "description": "target_user parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -36461,6 +36417,14 @@
           "type": "string"
         }
       },
+      "app_slug": {
+        "name": "app_slug",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "type": "string"
+        }
+      },
       "authorization_id": {
         "name": "authorization_id",
         "description": "authorization_id parameter",
@@ -36799,6 +36763,14 @@
         "schema": {
           "type": "integer"
         }
+      },
+      "repository_id": {
+        "name": "repository_id",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "type": "integer"
+        }
       }
     },
     "schemas": {
diff --git a/descriptions/ghes-2.18/ghes-2.18.yaml b/descriptions/ghes-2.18/ghes-2.18.yaml
index 7e35d3031..1e626db58 100644
--- a/descriptions/ghes-2.18/ghes-2.18.yaml
+++ b/descriptions/ghes-2.18/ghes-2.18.yaml
@@ -1,7 +1,7 @@
 ---
 openapi: 3.0.3
 info:
-  version: 0.0.7
+  version: 1.0.0-rc.1
   title: GitHub v3 REST API
   description: GitHub's v3 REST API.
   license:
@@ -1819,7 +1819,6 @@ paths:
         url: https://developer.github.com/enterprise/2.18/v3/apps/#create-a-github-app-from-a-manifest
       parameters:
       - name: code
-        description: code parameter
         in: path
         required: true
         schema:
@@ -2301,12 +2300,7 @@ paths:
         description: API method documentation
         url: https://developer.github.com/enterprise/2.18/v3/apps/#get-an-app
       parameters:
-      - name: app_slug
-        description: app_slug parameter
-        in: path
-        required: true
-        schema:
-          type: string
+      - "$ref": "#/components/parameters/app_slug"
       responses:
         '200':
           description: response
@@ -2597,7 +2591,6 @@ paths:
       parameters:
       - "$ref": "#/components/parameters/client-id"
       - name: fingerprint
-        description: fingerprint parameter
         in: path
         required: true
         schema:
@@ -2876,7 +2869,6 @@ paths:
         url: https://developer.github.com/enterprise/2.18/v3/codes_of_conduct/#get-a-code-of-conduct
       parameters:
       - name: key
-        description: key parameter
         in: path
         required: true
         schema:
@@ -2929,7 +2921,6 @@ paths:
         url: https://developer.github.com/enterprise/2.18/v3/apps/installations/#create-a-content-attachment
       parameters:
       - name: content_reference_id
-        description: content_reference_id parameter
         in: path
         required: true
         schema:
@@ -3918,7 +3909,6 @@ paths:
       parameters:
       - "$ref": "#/components/parameters/gist_id"
       - name: sha
-        description: sha parameter
         in: path
         required: true
         schema:
@@ -3996,7 +3986,6 @@ paths:
         url: https://developer.github.com/enterprise/2.18/v3/gitignore/#get-a-gitignore-template
       parameters:
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -4250,7 +4239,6 @@ paths:
         url: https://developer.github.com/enterprise/2.18/v3/licenses/#get-a-license
       parameters:
       - name: license
-        description: license parameter
         in: path
         required: true
         schema:
@@ -8210,7 +8198,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: assignee
-        description: assignee parameter
         in: path
         required: true
         schema:
@@ -11771,13 +11758,11 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: base
-        description: base parameter
         in: path
         required: true
         schema:
           type: string
       - name: head
-        description: head parameter
         in: path
         required: true
         schema:
@@ -12693,7 +12678,6 @@ paths:
       - "$ref": "#/components/parameters/repo"
       - "$ref": "#/components/parameters/deployment_id"
       - name: status_id
-        description: status_id parameter
         in: path
         required: true
         schema:
@@ -12942,7 +12926,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: file_sha
-        description: file_sha parameter
         in: path
         required: true
         schema:
@@ -13526,7 +13509,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: tag_sha
-        description: tag_sha parameter
         in: path
         required: true
         schema:
@@ -13674,7 +13656,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: tree_sha
-        description: tree_sha parameter
         in: path
         required: true
         schema:
@@ -14807,7 +14788,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: event_id
-        description: event_id parameter
         in: path
         required: true
         schema:
@@ -15453,7 +15433,6 @@ paths:
       - "$ref": "#/components/parameters/repo"
       - "$ref": "#/components/parameters/issue_number"
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -16020,7 +15999,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -16056,7 +16034,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -16648,6 +16625,8 @@ paths:
               properties:
                 source:
                   type: object
+                  description: The source branch and directory used to publish your
+                    Pages site.
                   properties:
                     branch:
                       type: string
@@ -16917,7 +16896,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: build_id
-        description: build_id parameter
         in: path
         required: true
         schema:
@@ -19518,12 +19496,10 @@ paths:
         in: query
         schema:
           type: string
-        description: name parameter
       - name: label
         in: query
         schema:
           type: string
-        description: label parameter
       requestBody:
         content:
           "*/*":
@@ -19793,7 +19769,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: sha
-        description: sha parameter
         in: path
         required: true
         schema:
@@ -20049,7 +20024,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: ref
-        description: ref parameter
         in: path
         required: true
         schema:
@@ -20340,7 +20314,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: ref
-        description: ref parameter
         in: path
         required: true
         schema:
@@ -20379,13 +20352,11 @@ paths:
         url: https://developer.github.com/enterprise/2.18/v3/repos/#create-a-repository-using-a-template
       parameters:
       - name: template_owner
-        description: template_owner parameter
         in: path
         required: true
         schema:
           type: string
       - name: template_repo
-        description: template_repo parameter
         in: path
         required: true
         schema:
@@ -24075,12 +24046,7 @@ paths:
         url: https://developer.github.com/enterprise/2.18/v3/apps/installations/#add-a-repository-to-an-app-installation
       parameters:
       - "$ref": "#/components/parameters/installation_id"
-      - name: repository_id
-        description: repository_id parameter
-        in: path
-        required: true
-        schema:
-          type: integer
+      - "$ref": "#/components/parameters/repository_id"
       responses:
         '204':
           description: Empty response
@@ -24110,12 +24076,7 @@ paths:
         url: https://developer.github.com/enterprise/2.18/v3/apps/installations/#remove-a-repository-from-an-app-installation
       parameters:
       - "$ref": "#/components/parameters/installation_id"
-      - name: repository_id
-        description: repository_id parameter
-        in: path
-        required: true
-        schema:
-          type: integer
+      - "$ref": "#/components/parameters/repository_id"
       responses:
         '204':
           description: Empty response
@@ -25525,7 +25486,6 @@ paths:
       parameters:
       - "$ref": "#/components/parameters/username"
       - name: target_user
-        description: target_user parameter
         in: path
         required: true
         schema:
@@ -26300,6 +26260,12 @@ components:
       required: true
       schema:
         type: string
+    app_slug:
+      name: app_slug
+      in: path
+      required: true
+      schema:
+        type: string
     authorization_id:
       name: authorization_id
       description: authorization_id parameter
@@ -26570,6 +26536,12 @@ components:
       required: true
       schema:
         type: integer
+    repository_id:
+      name: repository_id
+      in: path
+      required: true
+      schema:
+        type: integer
   schemas:
     global-hook:
       type: object
diff --git a/descriptions/ghes-2.19/dereferenced/ghes-2.19.deref.json b/descriptions/ghes-2.19/dereferenced/ghes-2.19.deref.json
index 95874954d..a37890ea4 100644
--- a/descriptions/ghes-2.19/dereferenced/ghes-2.19.deref.json
+++ b/descriptions/ghes-2.19/dereferenced/ghes-2.19.deref.json
@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "0.0.7",
+    "version": "1.0.0-rc.1",
     "title": "GitHub v3 REST API",
     "description": "GitHub's v3 REST API.",
     "license": {
@@ -5156,7 +5156,6 @@
         "parameters": [
           {
             "name": "code",
-            "description": "code parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -9355,7 +9354,6 @@
         "parameters": [
           {
             "name": "app_slug",
-            "description": "app_slug parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -11924,7 +11922,6 @@
           },
           {
             "name": "fingerprint",
-            "description": "fingerprint parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -14149,7 +14146,6 @@
         "parameters": [
           {
             "name": "key",
-            "description": "key parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -14287,7 +14283,6 @@
         "parameters": [
           {
             "name": "content_reference_id",
-            "description": "content_reference_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -25232,7 +25227,6 @@
           },
           {
             "name": "sha",
-            "description": "sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -26093,7 +26087,6 @@
         "parameters": [
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -30217,7 +30210,6 @@
         "parameters": [
           {
             "name": "license",
-            "description": "license parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -65388,7 +65380,6 @@
           },
           {
             "name": "assignee",
-            "description": "assignee parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -96893,7 +96884,6 @@
           },
           {
             "name": "base",
-            "description": "base parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -96902,7 +96892,6 @@
           },
           {
             "name": "head",
-            "description": "head parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -104303,7 +104292,6 @@
           },
           {
             "name": "status_id",
-            "description": "status_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -109942,7 +109930,6 @@
           },
           {
             "name": "file_sha",
-            "description": "file_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -111949,7 +111936,6 @@
           },
           {
             "name": "tag_sha",
-            "description": "tag_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -112511,7 +112497,6 @@
           },
           {
             "name": "tree_sha",
-            "description": "tree_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -128112,7 +128097,6 @@
           },
           {
             "name": "event_id",
-            "description": "event_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -143255,7 +143239,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -145742,7 +145725,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -145880,7 +145862,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -146026,7 +146007,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -149935,6 +149915,7 @@
                 "properties": {
                   "source": {
                     "type": "object",
+                    "description": "The source branch and directory used to publish your Pages site.",
                     "properties": {
                       "branch": {
                         "type": "string",
@@ -151211,7 +151192,6 @@
           },
           {
             "name": "build_id",
-            "description": "build_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -183565,16 +183545,14 @@
             "in": "query",
             "schema": {
               "type": "string"
-            },
-            "description": "name parameter"
+            }
           },
           {
             "name": "label",
             "in": "query",
             "schema": {
               "type": "string"
-            },
-            "description": "label parameter"
+            }
           }
         ],
         "requestBody": {
@@ -185031,7 +185009,6 @@
           },
           {
             "name": "sha",
-            "description": "sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -185980,7 +185957,6 @@
           },
           {
             "name": "ref",
-            "description": "ref parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -187850,7 +187826,6 @@
           },
           {
             "name": "ref",
-            "description": "ref parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -187897,7 +187872,6 @@
         "parameters": [
           {
             "name": "template_owner",
-            "description": "template_owner parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -187906,7 +187880,6 @@
           },
           {
             "name": "template_repo",
-            "description": "template_repo parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -215706,7 +215679,6 @@
           },
           {
             "name": "repository_id",
-            "description": "repository_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -215795,7 +215767,6 @@
           },
           {
             "name": "repository_id",
-            "description": "repository_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -238491,7 +238462,6 @@
           },
           {
             "name": "target_user",
-            "description": "target_user parameter",
             "in": "path",
             "required": true,
             "schema": {
diff --git a/descriptions/ghes-2.19/dereferenced/ghes-2.19.deref.yaml b/descriptions/ghes-2.19/dereferenced/ghes-2.19.deref.yaml
index 8593eee0a..da9d0927f 100644
--- a/descriptions/ghes-2.19/dereferenced/ghes-2.19.deref.yaml
+++ b/descriptions/ghes-2.19/dereferenced/ghes-2.19.deref.yaml
@@ -1,7 +1,7 @@
 ---
 openapi: 3.0.3
 info:
-  version: 0.0.7
+  version: 1.0.0-rc.1
   title: GitHub v3 REST API
   description: GitHub's v3 REST API.
   license:
@@ -3828,7 +3828,6 @@ paths:
         url: https://developer.github.com/enterprise/2.19/v3/apps/#create-a-github-app-from-a-manifest
       parameters:
       - name: code
-        description: code parameter
         in: path
         required: true
         schema:
@@ -7033,7 +7032,6 @@ paths:
         url: https://developer.github.com/enterprise/2.19/v3/apps/#get-an-app
       parameters:
       - name: app_slug
-        description: app_slug parameter
         in: path
         required: true
         schema:
@@ -9017,7 +9015,6 @@ paths:
         schema:
           type: string
       - name: fingerprint
-        description: fingerprint parameter
         in: path
         required: true
         schema:
@@ -10766,7 +10763,6 @@ paths:
         url: https://developer.github.com/enterprise/2.19/v3/codes_of_conduct/#get-a-code-of-conduct
       parameters:
       - name: key
-        description: key parameter
         in: path
         required: true
         schema:
@@ -10968,7 +10964,6 @@ paths:
         url: https://developer.github.com/enterprise/2.19/v3/apps/installations/#create-a-content-attachment
       parameters:
       - name: content_reference_id
-        description: content_reference_id parameter
         in: path
         required: true
         schema:
@@ -19040,7 +19035,6 @@ paths:
         schema:
           type: string
       - name: sha
-        description: sha parameter
         in: path
         required: true
         schema:
@@ -19649,7 +19643,6 @@ paths:
         url: https://developer.github.com/enterprise/2.19/v3/gitignore/#get-a-gitignore-template
       parameters:
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -22886,7 +22879,6 @@ paths:
         url: https://developer.github.com/enterprise/2.19/v3/licenses/#get-a-license
       parameters:
       - name: license
-        description: license parameter
         in: path
         required: true
         schema:
@@ -49978,7 +49970,6 @@ paths:
         schema:
           type: string
       - name: assignee
-        description: assignee parameter
         in: path
         required: true
         schema:
@@ -74333,13 +74324,11 @@ paths:
         schema:
           type: string
       - name: base
-        description: base parameter
         in: path
         required: true
         schema:
           type: string
       - name: head
-        description: head parameter
         in: path
         required: true
         schema:
@@ -80093,7 +80082,6 @@ paths:
         schema:
           type: integer
       - name: status_id
-        description: status_id parameter
         in: path
         required: true
         schema:
@@ -84424,7 +84412,6 @@ paths:
         schema:
           type: string
       - name: file_sha
-        description: file_sha parameter
         in: path
         required: true
         schema:
@@ -85942,7 +85929,6 @@ paths:
         schema:
           type: string
       - name: tag_sha
-        description: tag_sha parameter
         in: path
         required: true
         schema:
@@ -86350,7 +86336,6 @@ paths:
         schema:
           type: string
       - name: tree_sha
-        description: tree_sha parameter
         in: path
         required: true
         schema:
@@ -98360,7 +98345,6 @@ paths:
         schema:
           type: string
       - name: event_id
-        description: event_id parameter
         in: path
         required: true
         schema:
@@ -110068,7 +110052,6 @@ paths:
         schema:
           type: integer
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -111858,7 +111841,6 @@ paths:
         schema:
           type: string
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -111958,7 +111940,6 @@ paths:
         schema:
           type: string
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -112069,7 +112050,6 @@ paths:
         schema:
           type: string
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -115037,6 +115017,8 @@ paths:
               properties:
                 source:
                   type: object
+                  description: The source branch and directory used to publish your
+                    Pages site.
                   properties:
                     branch:
                       type: string
@@ -115950,7 +115932,6 @@ paths:
         schema:
           type: string
       - name: build_id
-        description: build_id parameter
         in: path
         required: true
         schema:
@@ -141251,12 +141232,10 @@ paths:
         in: query
         schema:
           type: string
-        description: name parameter
       - name: label
         in: query
         schema:
           type: string
-        description: label parameter
       requestBody:
         content:
           "*/*":
@@ -142367,7 +142346,6 @@ paths:
         schema:
           type: string
       - name: sha
-        description: sha parameter
         in: path
         required: true
         schema:
@@ -143079,7 +143057,6 @@ paths:
         schema:
           type: string
       - name: ref
-        description: ref parameter
         in: path
         required: true
         schema:
@@ -144492,7 +144469,6 @@ paths:
         schema:
           type: string
       - name: ref
-        description: ref parameter
         in: path
         required: true
         schema:
@@ -144531,13 +144507,11 @@ paths:
         url: https://developer.github.com/enterprise/2.19/v3/repos/#create-a-repository-using-a-template
       parameters:
       - name: template_owner
-        description: template_owner parameter
         in: path
         required: true
         schema:
           type: string
       - name: template_repo
-        description: template_repo parameter
         in: path
         required: true
         schema:
@@ -165956,7 +165930,6 @@ paths:
         schema:
           type: integer
       - name: repository_id
-        description: repository_id parameter
         in: path
         required: true
         schema:
@@ -166018,7 +165991,6 @@ paths:
         schema:
           type: integer
       - name: repository_id
-        description: repository_id parameter
         in: path
         required: true
         schema:
@@ -183440,7 +183412,6 @@ paths:
         schema:
           type: string
       - name: target_user
-        description: target_user parameter
         in: path
         required: true
         schema:
diff --git a/descriptions/ghes-2.19/ghes-2.19.json b/descriptions/ghes-2.19/ghes-2.19.json
index f3d1e1344..acf25309b 100644
--- a/descriptions/ghes-2.19/ghes-2.19.json
+++ b/descriptions/ghes-2.19/ghes-2.19.json
@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "0.0.7",
+    "version": "1.0.0-rc.1",
     "title": "GitHub v3 REST API",
     "description": "GitHub's v3 REST API.",
     "license": {
@@ -2518,7 +2518,6 @@
         "parameters": [
           {
             "name": "code",
-            "description": "code parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -3205,13 +3204,7 @@
         },
         "parameters": [
           {
-            "name": "app_slug",
-            "description": "app_slug parameter",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
-            }
+            "$ref": "#/components/parameters/app_slug"
           }
         ],
         "responses": {
@@ -3588,7 +3581,6 @@
           },
           {
             "name": "fingerprint",
-            "description": "fingerprint parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -3971,7 +3963,6 @@
         "parameters": [
           {
             "name": "key",
-            "description": "key parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -4035,7 +4026,6 @@
         "parameters": [
           {
             "name": "content_reference_id",
-            "description": "content_reference_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -5540,7 +5530,6 @@
           },
           {
             "name": "sha",
-            "description": "sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -5653,7 +5642,6 @@
         "parameters": [
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -6004,7 +5992,6 @@
         "parameters": [
           {
             "name": "license",
-            "description": "license parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -11479,7 +11466,6 @@
           },
           {
             "name": "assignee",
-            "description": "assignee parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -16496,7 +16482,6 @@
           },
           {
             "name": "base",
-            "description": "base parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -16505,7 +16490,6 @@
           },
           {
             "name": "head",
-            "description": "head parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -17636,7 +17620,6 @@
           },
           {
             "name": "status_id",
-            "description": "status_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -18008,7 +17991,6 @@
           },
           {
             "name": "file_sha",
-            "description": "file_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -18753,7 +18735,6 @@
           },
           {
             "name": "tag_sha",
-            "description": "tag_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -18949,7 +18930,6 @@
           },
           {
             "name": "tree_sha",
-            "description": "tree_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -20594,7 +20574,6 @@
           },
           {
             "name": "event_id",
-            "description": "event_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -21548,7 +21527,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -22396,7 +22374,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -22454,7 +22431,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -22537,7 +22513,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -23458,6 +23433,7 @@
                 "properties": {
                   "source": {
                     "type": "object",
+                    "description": "The source branch and directory used to publish your Pages site.",
                     "properties": {
                       "branch": {
                         "type": "string",
@@ -23857,7 +23833,6 @@
           },
           {
             "name": "build_id",
-            "description": "build_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -27518,16 +27493,14 @@
             "in": "query",
             "schema": {
               "type": "string"
-            },
-            "description": "name parameter"
+            }
           },
           {
             "name": "label",
             "in": "query",
             "schema": {
               "type": "string"
-            },
-            "description": "label parameter"
+            }
           }
         ],
         "requestBody": {
@@ -27922,7 +27895,6 @@
           },
           {
             "name": "sha",
-            "description": "sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -28307,7 +28279,6 @@
           },
           {
             "name": "ref",
-            "description": "ref parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -28723,7 +28694,6 @@
           },
           {
             "name": "ref",
-            "description": "ref parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -28770,7 +28740,6 @@
         "parameters": [
           {
             "name": "template_owner",
-            "description": "template_owner parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -28779,7 +28748,6 @@
           },
           {
             "name": "template_repo",
-            "description": "template_repo parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -33686,13 +33654,7 @@
             "$ref": "#/components/parameters/installation_id"
           },
           {
-            "name": "repository_id",
-            "description": "repository_id parameter",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "integer"
-            }
+            "$ref": "#/components/parameters/repository_id"
           }
         ],
         "responses": {
@@ -33735,13 +33697,7 @@
             "$ref": "#/components/parameters/installation_id"
           },
           {
-            "name": "repository_id",
-            "description": "repository_id parameter",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "integer"
-            }
+            "$ref": "#/components/parameters/repository_id"
           }
         ],
         "responses": {
@@ -35814,7 +35770,6 @@
           },
           {
             "name": "target_user",
-            "description": "target_user parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -36954,6 +36909,14 @@
           "type": "string"
         }
       },
+      "app_slug": {
+        "name": "app_slug",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "type": "string"
+        }
+      },
       "authorization_id": {
         "name": "authorization_id",
         "description": "authorization_id parameter",
@@ -37292,6 +37255,14 @@
         "schema": {
           "type": "integer"
         }
+      },
+      "repository_id": {
+        "name": "repository_id",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "type": "integer"
+        }
       }
     },
     "schemas": {
diff --git a/descriptions/ghes-2.19/ghes-2.19.yaml b/descriptions/ghes-2.19/ghes-2.19.yaml
index 1174fd34a..45cbde0d6 100644
--- a/descriptions/ghes-2.19/ghes-2.19.yaml
+++ b/descriptions/ghes-2.19/ghes-2.19.yaml
@@ -1,7 +1,7 @@
 ---
 openapi: 3.0.3
 info:
-  version: 0.0.7
+  version: 1.0.0-rc.1
   title: GitHub v3 REST API
   description: GitHub's v3 REST API.
   license:
@@ -1819,7 +1819,6 @@ paths:
         url: https://developer.github.com/enterprise/2.19/v3/apps/#create-a-github-app-from-a-manifest
       parameters:
       - name: code
-        description: code parameter
         in: path
         required: true
         schema:
@@ -2301,12 +2300,7 @@ paths:
         description: API method documentation
         url: https://developer.github.com/enterprise/2.19/v3/apps/#get-an-app
       parameters:
-      - name: app_slug
-        description: app_slug parameter
-        in: path
-        required: true
-        schema:
-          type: string
+      - "$ref": "#/components/parameters/app_slug"
       responses:
         '200':
           description: response
@@ -2597,7 +2591,6 @@ paths:
       parameters:
       - "$ref": "#/components/parameters/client-id"
       - name: fingerprint
-        description: fingerprint parameter
         in: path
         required: true
         schema:
@@ -2876,7 +2869,6 @@ paths:
         url: https://developer.github.com/enterprise/2.19/v3/codes_of_conduct/#get-a-code-of-conduct
       parameters:
       - name: key
-        description: key parameter
         in: path
         required: true
         schema:
@@ -2929,7 +2921,6 @@ paths:
         url: https://developer.github.com/enterprise/2.19/v3/apps/installations/#create-a-content-attachment
       parameters:
       - name: content_reference_id
-        description: content_reference_id parameter
         in: path
         required: true
         schema:
@@ -3918,7 +3909,6 @@ paths:
       parameters:
       - "$ref": "#/components/parameters/gist_id"
       - name: sha
-        description: sha parameter
         in: path
         required: true
         schema:
@@ -3996,7 +3986,6 @@ paths:
         url: https://developer.github.com/enterprise/2.19/v3/gitignore/#get-a-gitignore-template
       parameters:
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -4250,7 +4239,6 @@ paths:
         url: https://developer.github.com/enterprise/2.19/v3/licenses/#get-a-license
       parameters:
       - name: license
-        description: license parameter
         in: path
         required: true
         schema:
@@ -8252,7 +8240,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: assignee
-        description: assignee parameter
         in: path
         required: true
         schema:
@@ -11997,13 +11984,11 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: base
-        description: base parameter
         in: path
         required: true
         schema:
           type: string
       - name: head
-        description: head parameter
         in: path
         required: true
         schema:
@@ -12919,7 +12904,6 @@ paths:
       - "$ref": "#/components/parameters/repo"
       - "$ref": "#/components/parameters/deployment_id"
       - name: status_id
-        description: status_id parameter
         in: path
         required: true
         schema:
@@ -13168,7 +13152,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: file_sha
-        description: file_sha parameter
         in: path
         required: true
         schema:
@@ -13798,7 +13781,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: tag_sha
-        description: tag_sha parameter
         in: path
         required: true
         schema:
@@ -13946,7 +13928,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: tree_sha
-        description: tree_sha parameter
         in: path
         required: true
         schema:
@@ -15079,7 +15060,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: event_id
-        description: event_id parameter
         in: path
         required: true
         schema:
@@ -15725,7 +15705,6 @@ paths:
       - "$ref": "#/components/parameters/repo"
       - "$ref": "#/components/parameters/issue_number"
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -16292,7 +16271,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -16328,7 +16306,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -16386,7 +16363,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -16978,6 +16954,8 @@ paths:
               properties:
                 source:
                   type: object
+                  description: The source branch and directory used to publish your
+                    Pages site.
                   properties:
                     branch:
                       type: string
@@ -17247,7 +17225,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: build_id
-        description: build_id parameter
         in: path
         required: true
         schema:
@@ -19848,12 +19825,10 @@ paths:
         in: query
         schema:
           type: string
-        description: name parameter
       - name: label
         in: query
         schema:
           type: string
-        description: label parameter
       requestBody:
         content:
           "*/*":
@@ -20123,7 +20098,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: sha
-        description: sha parameter
         in: path
         required: true
         schema:
@@ -20379,7 +20353,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: ref
-        description: ref parameter
         in: path
         required: true
         schema:
@@ -20670,7 +20643,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: ref
-        description: ref parameter
         in: path
         required: true
         schema:
@@ -20709,13 +20681,11 @@ paths:
         url: https://developer.github.com/enterprise/2.19/v3/repos/#create-a-repository-using-a-template
       parameters:
       - name: template_owner
-        description: template_owner parameter
         in: path
         required: true
         schema:
           type: string
       - name: template_repo
-        description: template_repo parameter
         in: path
         required: true
         schema:
@@ -24405,12 +24375,7 @@ paths:
         url: https://developer.github.com/enterprise/2.19/v3/apps/installations/#add-a-repository-to-an-app-installation
       parameters:
       - "$ref": "#/components/parameters/installation_id"
-      - name: repository_id
-        description: repository_id parameter
-        in: path
-        required: true
-        schema:
-          type: integer
+      - "$ref": "#/components/parameters/repository_id"
       responses:
         '204':
           description: Empty response
@@ -24440,12 +24405,7 @@ paths:
         url: https://developer.github.com/enterprise/2.19/v3/apps/installations/#remove-a-repository-from-an-app-installation
       parameters:
       - "$ref": "#/components/parameters/installation_id"
-      - name: repository_id
-        description: repository_id parameter
-        in: path
-        required: true
-        schema:
-          type: integer
+      - "$ref": "#/components/parameters/repository_id"
       responses:
         '204':
           description: Empty response
@@ -25855,7 +25815,6 @@ paths:
       parameters:
       - "$ref": "#/components/parameters/username"
       - name: target_user
-        description: target_user parameter
         in: path
         required: true
         schema:
@@ -26630,6 +26589,12 @@ components:
       required: true
       schema:
         type: string
+    app_slug:
+      name: app_slug
+      in: path
+      required: true
+      schema:
+        type: string
     authorization_id:
       name: authorization_id
       description: authorization_id parameter
@@ -26900,6 +26865,12 @@ components:
       required: true
       schema:
         type: integer
+    repository_id:
+      name: repository_id
+      in: path
+      required: true
+      schema:
+        type: integer
   schemas:
     global-hook:
       type: object
diff --git a/descriptions/ghes-2.20/dereferenced/ghes-2.20.deref.json b/descriptions/ghes-2.20/dereferenced/ghes-2.20.deref.json
index 6083fdb29..036df2555 100644
--- a/descriptions/ghes-2.20/dereferenced/ghes-2.20.deref.json
+++ b/descriptions/ghes-2.20/dereferenced/ghes-2.20.deref.json
@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "0.0.7",
+    "version": "1.0.0-rc.1",
     "title": "GitHub v3 REST API",
     "description": "GitHub's v3 REST API.",
     "license": {
@@ -5156,7 +5156,6 @@
         "parameters": [
           {
             "name": "code",
-            "description": "code parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -11272,7 +11271,6 @@
         "parameters": [
           {
             "name": "app_slug",
-            "description": "app_slug parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -13841,7 +13839,6 @@
           },
           {
             "name": "fingerprint",
-            "description": "fingerprint parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -16066,7 +16063,6 @@
         "parameters": [
           {
             "name": "key",
-            "description": "key parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -16204,7 +16200,6 @@
         "parameters": [
           {
             "name": "content_reference_id",
-            "description": "content_reference_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -27149,7 +27144,6 @@
           },
           {
             "name": "sha",
-            "description": "sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -28010,7 +28004,6 @@
         "parameters": [
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -32165,7 +32158,6 @@
         "parameters": [
           {
             "name": "license",
-            "description": "license parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -67336,7 +67328,6 @@
           },
           {
             "name": "assignee",
-            "description": "assignee parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -98841,7 +98832,6 @@
           },
           {
             "name": "base",
-            "description": "base parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -98850,7 +98840,6 @@
           },
           {
             "name": "head",
-            "description": "head parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -106251,7 +106240,6 @@
           },
           {
             "name": "status_id",
-            "description": "status_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -111890,7 +111878,6 @@
           },
           {
             "name": "file_sha",
-            "description": "file_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -113897,7 +113884,6 @@
           },
           {
             "name": "tag_sha",
-            "description": "tag_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -114459,7 +114445,6 @@
           },
           {
             "name": "tree_sha",
-            "description": "tree_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -130060,7 +130045,6 @@
           },
           {
             "name": "event_id",
-            "description": "event_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -145203,7 +145187,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -147690,7 +147673,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -147828,7 +147810,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -147974,7 +147955,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -151883,6 +151863,7 @@
                 "properties": {
                   "source": {
                     "type": "object",
+                    "description": "The source branch and directory used to publish your Pages site.",
                     "properties": {
                       "branch": {
                         "type": "string",
@@ -153159,7 +153140,6 @@
           },
           {
             "name": "build_id",
-            "description": "build_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -185901,16 +185881,14 @@
             "in": "query",
             "schema": {
               "type": "string"
-            },
-            "description": "name parameter"
+            }
           },
           {
             "name": "label",
             "in": "query",
             "schema": {
               "type": "string"
-            },
-            "description": "label parameter"
+            }
           }
         ],
         "requestBody": {
@@ -187367,7 +187345,6 @@
           },
           {
             "name": "sha",
-            "description": "sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -188316,7 +188293,6 @@
           },
           {
             "name": "ref",
-            "description": "ref parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -190186,7 +190162,6 @@
           },
           {
             "name": "ref",
-            "description": "ref parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -190233,7 +190208,6 @@
         "parameters": [
           {
             "name": "template_owner",
-            "description": "template_owner parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -190242,7 +190216,6 @@
           },
           {
             "name": "template_repo",
-            "description": "template_repo parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -218042,7 +218015,6 @@
           },
           {
             "name": "repository_id",
-            "description": "repository_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -218131,7 +218103,6 @@
           },
           {
             "name": "repository_id",
-            "description": "repository_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -240827,7 +240798,6 @@
           },
           {
             "name": "target_user",
-            "description": "target_user parameter",
             "in": "path",
             "required": true,
             "schema": {
diff --git a/descriptions/ghes-2.20/dereferenced/ghes-2.20.deref.yaml b/descriptions/ghes-2.20/dereferenced/ghes-2.20.deref.yaml
index fb409e771..8b05cc5e0 100644
--- a/descriptions/ghes-2.20/dereferenced/ghes-2.20.deref.yaml
+++ b/descriptions/ghes-2.20/dereferenced/ghes-2.20.deref.yaml
@@ -1,7 +1,7 @@
 ---
 openapi: 3.0.3
 info:
-  version: 0.0.7
+  version: 1.0.0-rc.1
   title: GitHub v3 REST API
   description: GitHub's v3 REST API.
   license:
@@ -3828,7 +3828,6 @@ paths:
         url: https://developer.github.com/enterprise/2.20/v3/apps/#create-a-github-app-from-a-manifest
       parameters:
       - name: code
-        description: code parameter
         in: path
         required: true
         schema:
@@ -8512,7 +8511,6 @@ paths:
         url: https://developer.github.com/enterprise/2.20/v3/apps/#get-an-app
       parameters:
       - name: app_slug
-        description: app_slug parameter
         in: path
         required: true
         schema:
@@ -10496,7 +10494,6 @@ paths:
         schema:
           type: string
       - name: fingerprint
-        description: fingerprint parameter
         in: path
         required: true
         schema:
@@ -12245,7 +12242,6 @@ paths:
         url: https://developer.github.com/enterprise/2.20/v3/codes_of_conduct/#get-a-code-of-conduct
       parameters:
       - name: key
-        description: key parameter
         in: path
         required: true
         schema:
@@ -12447,7 +12443,6 @@ paths:
         url: https://developer.github.com/enterprise/2.20/v3/apps/installations/#create-a-content-attachment
       parameters:
       - name: content_reference_id
-        description: content_reference_id parameter
         in: path
         required: true
         schema:
@@ -20519,7 +20514,6 @@ paths:
         schema:
           type: string
       - name: sha
-        description: sha parameter
         in: path
         required: true
         schema:
@@ -21128,7 +21122,6 @@ paths:
         url: https://developer.github.com/enterprise/2.20/v3/gitignore/#get-a-gitignore-template
       parameters:
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -24390,7 +24383,6 @@ paths:
         url: https://developer.github.com/enterprise/2.20/v3/licenses/#get-a-license
       parameters:
       - name: license
-        description: license parameter
         in: path
         required: true
         schema:
@@ -51482,7 +51474,6 @@ paths:
         schema:
           type: string
       - name: assignee
-        description: assignee parameter
         in: path
         required: true
         schema:
@@ -75837,13 +75828,11 @@ paths:
         schema:
           type: string
       - name: base
-        description: base parameter
         in: path
         required: true
         schema:
           type: string
       - name: head
-        description: head parameter
         in: path
         required: true
         schema:
@@ -81597,7 +81586,6 @@ paths:
         schema:
           type: integer
       - name: status_id
-        description: status_id parameter
         in: path
         required: true
         schema:
@@ -85928,7 +85916,6 @@ paths:
         schema:
           type: string
       - name: file_sha
-        description: file_sha parameter
         in: path
         required: true
         schema:
@@ -87446,7 +87433,6 @@ paths:
         schema:
           type: string
       - name: tag_sha
-        description: tag_sha parameter
         in: path
         required: true
         schema:
@@ -87854,7 +87840,6 @@ paths:
         schema:
           type: string
       - name: tree_sha
-        description: tree_sha parameter
         in: path
         required: true
         schema:
@@ -99864,7 +99849,6 @@ paths:
         schema:
           type: string
       - name: event_id
-        description: event_id parameter
         in: path
         required: true
         schema:
@@ -111572,7 +111556,6 @@ paths:
         schema:
           type: integer
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -113362,7 +113345,6 @@ paths:
         schema:
           type: string
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -113462,7 +113444,6 @@ paths:
         schema:
           type: string
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -113573,7 +113554,6 @@ paths:
         schema:
           type: string
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -116541,6 +116521,8 @@ paths:
               properties:
                 source:
                   type: object
+                  description: The source branch and directory used to publish your
+                    Pages site.
                   properties:
                     branch:
                       type: string
@@ -117454,7 +117436,6 @@ paths:
         schema:
           type: string
       - name: build_id
-        description: build_id parameter
         in: path
         required: true
         schema:
@@ -143126,12 +143107,10 @@ paths:
         in: query
         schema:
           type: string
-        description: name parameter
       - name: label
         in: query
         schema:
           type: string
-        description: label parameter
       requestBody:
         content:
           "*/*":
@@ -144242,7 +144221,6 @@ paths:
         schema:
           type: string
       - name: sha
-        description: sha parameter
         in: path
         required: true
         schema:
@@ -144954,7 +144932,6 @@ paths:
         schema:
           type: string
       - name: ref
-        description: ref parameter
         in: path
         required: true
         schema:
@@ -146367,7 +146344,6 @@ paths:
         schema:
           type: string
       - name: ref
-        description: ref parameter
         in: path
         required: true
         schema:
@@ -146406,13 +146382,11 @@ paths:
         url: https://developer.github.com/enterprise/2.20/v3/repos/#create-a-repository-using-a-template
       parameters:
       - name: template_owner
-        description: template_owner parameter
         in: path
         required: true
         schema:
           type: string
       - name: template_repo
-        description: template_repo parameter
         in: path
         required: true
         schema:
@@ -167831,7 +167805,6 @@ paths:
         schema:
           type: integer
       - name: repository_id
-        description: repository_id parameter
         in: path
         required: true
         schema:
@@ -167893,7 +167866,6 @@ paths:
         schema:
           type: integer
       - name: repository_id
-        description: repository_id parameter
         in: path
         required: true
         schema:
@@ -185315,7 +185287,6 @@ paths:
         schema:
           type: string
       - name: target_user
-        description: target_user parameter
         in: path
         required: true
         schema:
diff --git a/descriptions/ghes-2.20/ghes-2.20.json b/descriptions/ghes-2.20/ghes-2.20.json
index d32fa9dbc..ce5689a8e 100644
--- a/descriptions/ghes-2.20/ghes-2.20.json
+++ b/descriptions/ghes-2.20/ghes-2.20.json
@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "0.0.7",
+    "version": "1.0.0-rc.1",
     "title": "GitHub v3 REST API",
     "description": "GitHub's v3 REST API.",
     "license": {
@@ -2518,7 +2518,6 @@
         "parameters": [
           {
             "name": "code",
-            "description": "code parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -3464,13 +3463,7 @@
         },
         "parameters": [
           {
-            "name": "app_slug",
-            "description": "app_slug parameter",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
-            }
+            "$ref": "#/components/parameters/app_slug"
           }
         ],
         "responses": {
@@ -3847,7 +3840,6 @@
           },
           {
             "name": "fingerprint",
-            "description": "fingerprint parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -4230,7 +4222,6 @@
         "parameters": [
           {
             "name": "key",
-            "description": "key parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -4294,7 +4285,6 @@
         "parameters": [
           {
             "name": "content_reference_id",
-            "description": "content_reference_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -5799,7 +5789,6 @@
           },
           {
             "name": "sha",
-            "description": "sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -5912,7 +5901,6 @@
         "parameters": [
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -6294,7 +6282,6 @@
         "parameters": [
           {
             "name": "license",
-            "description": "license parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -11769,7 +11756,6 @@
           },
           {
             "name": "assignee",
-            "description": "assignee parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -16786,7 +16772,6 @@
           },
           {
             "name": "base",
-            "description": "base parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -16795,7 +16780,6 @@
           },
           {
             "name": "head",
-            "description": "head parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -17926,7 +17910,6 @@
           },
           {
             "name": "status_id",
-            "description": "status_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -18298,7 +18281,6 @@
           },
           {
             "name": "file_sha",
-            "description": "file_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -19043,7 +19025,6 @@
           },
           {
             "name": "tag_sha",
-            "description": "tag_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -19239,7 +19220,6 @@
           },
           {
             "name": "tree_sha",
-            "description": "tree_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -20884,7 +20864,6 @@
           },
           {
             "name": "event_id",
-            "description": "event_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -21838,7 +21817,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -22686,7 +22664,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -22744,7 +22721,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -22827,7 +22803,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -23748,6 +23723,7 @@
                 "properties": {
                   "source": {
                     "type": "object",
+                    "description": "The source branch and directory used to publish your Pages site.",
                     "properties": {
                       "branch": {
                         "type": "string",
@@ -24147,7 +24123,6 @@
           },
           {
             "name": "build_id",
-            "description": "build_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -27877,16 +27852,14 @@
             "in": "query",
             "schema": {
               "type": "string"
-            },
-            "description": "name parameter"
+            }
           },
           {
             "name": "label",
             "in": "query",
             "schema": {
               "type": "string"
-            },
-            "description": "label parameter"
+            }
           }
         ],
         "requestBody": {
@@ -28281,7 +28254,6 @@
           },
           {
             "name": "sha",
-            "description": "sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -28666,7 +28638,6 @@
           },
           {
             "name": "ref",
-            "description": "ref parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -29082,7 +29053,6 @@
           },
           {
             "name": "ref",
-            "description": "ref parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -29129,7 +29099,6 @@
         "parameters": [
           {
             "name": "template_owner",
-            "description": "template_owner parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -29138,7 +29107,6 @@
           },
           {
             "name": "template_repo",
-            "description": "template_repo parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -34045,13 +34013,7 @@
             "$ref": "#/components/parameters/installation_id"
           },
           {
-            "name": "repository_id",
-            "description": "repository_id parameter",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "integer"
-            }
+            "$ref": "#/components/parameters/repository_id"
           }
         ],
         "responses": {
@@ -34094,13 +34056,7 @@
             "$ref": "#/components/parameters/installation_id"
           },
           {
-            "name": "repository_id",
-            "description": "repository_id parameter",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "integer"
-            }
+            "$ref": "#/components/parameters/repository_id"
           }
         ],
         "responses": {
@@ -36173,7 +36129,6 @@
           },
           {
             "name": "target_user",
-            "description": "target_user parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -37313,6 +37268,14 @@
           "type": "string"
         }
       },
+      "app_slug": {
+        "name": "app_slug",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "type": "string"
+        }
+      },
       "authorization_id": {
         "name": "authorization_id",
         "description": "authorization_id parameter",
@@ -37651,6 +37614,14 @@
         "schema": {
           "type": "integer"
         }
+      },
+      "repository_id": {
+        "name": "repository_id",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "type": "integer"
+        }
       }
     },
     "schemas": {
diff --git a/descriptions/ghes-2.20/ghes-2.20.yaml b/descriptions/ghes-2.20/ghes-2.20.yaml
index 2b53d26a5..03f433db4 100644
--- a/descriptions/ghes-2.20/ghes-2.20.yaml
+++ b/descriptions/ghes-2.20/ghes-2.20.yaml
@@ -1,7 +1,7 @@
 ---
 openapi: 3.0.3
 info:
-  version: 0.0.7
+  version: 1.0.0-rc.1
   title: GitHub v3 REST API
   description: GitHub's v3 REST API.
   license:
@@ -1819,7 +1819,6 @@ paths:
         url: https://developer.github.com/enterprise/2.20/v3/apps/#create-a-github-app-from-a-manifest
       parameters:
       - name: code
-        description: code parameter
         in: path
         required: true
         schema:
@@ -2482,12 +2481,7 @@ paths:
         description: API method documentation
         url: https://developer.github.com/enterprise/2.20/v3/apps/#get-an-app
       parameters:
-      - name: app_slug
-        description: app_slug parameter
-        in: path
-        required: true
-        schema:
-          type: string
+      - "$ref": "#/components/parameters/app_slug"
       responses:
         '200':
           description: response
@@ -2778,7 +2772,6 @@ paths:
       parameters:
       - "$ref": "#/components/parameters/client-id"
       - name: fingerprint
-        description: fingerprint parameter
         in: path
         required: true
         schema:
@@ -3057,7 +3050,6 @@ paths:
         url: https://developer.github.com/enterprise/2.20/v3/codes_of_conduct/#get-a-code-of-conduct
       parameters:
       - name: key
-        description: key parameter
         in: path
         required: true
         schema:
@@ -3110,7 +3102,6 @@ paths:
         url: https://developer.github.com/enterprise/2.20/v3/apps/installations/#create-a-content-attachment
       parameters:
       - name: content_reference_id
-        description: content_reference_id parameter
         in: path
         required: true
         schema:
@@ -4099,7 +4090,6 @@ paths:
       parameters:
       - "$ref": "#/components/parameters/gist_id"
       - name: sha
-        description: sha parameter
         in: path
         required: true
         schema:
@@ -4177,7 +4167,6 @@ paths:
         url: https://developer.github.com/enterprise/2.20/v3/gitignore/#get-a-gitignore-template
       parameters:
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -4456,7 +4445,6 @@ paths:
         url: https://developer.github.com/enterprise/2.20/v3/licenses/#get-a-license
       parameters:
       - name: license
-        description: license parameter
         in: path
         required: true
         schema:
@@ -8458,7 +8446,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: assignee
-        description: assignee parameter
         in: path
         required: true
         schema:
@@ -12203,13 +12190,11 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: base
-        description: base parameter
         in: path
         required: true
         schema:
           type: string
       - name: head
-        description: head parameter
         in: path
         required: true
         schema:
@@ -13125,7 +13110,6 @@ paths:
       - "$ref": "#/components/parameters/repo"
       - "$ref": "#/components/parameters/deployment_id"
       - name: status_id
-        description: status_id parameter
         in: path
         required: true
         schema:
@@ -13374,7 +13358,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: file_sha
-        description: file_sha parameter
         in: path
         required: true
         schema:
@@ -14004,7 +13987,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: tag_sha
-        description: tag_sha parameter
         in: path
         required: true
         schema:
@@ -14152,7 +14134,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: tree_sha
-        description: tree_sha parameter
         in: path
         required: true
         schema:
@@ -15285,7 +15266,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: event_id
-        description: event_id parameter
         in: path
         required: true
         schema:
@@ -15931,7 +15911,6 @@ paths:
       - "$ref": "#/components/parameters/repo"
       - "$ref": "#/components/parameters/issue_number"
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -16498,7 +16477,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -16534,7 +16512,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -16592,7 +16569,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -17184,6 +17160,8 @@ paths:
               properties:
                 source:
                   type: object
+                  description: The source branch and directory used to publish your
+                    Pages site.
                   properties:
                     branch:
                       type: string
@@ -17453,7 +17431,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: build_id
-        description: build_id parameter
         in: path
         required: true
         schema:
@@ -20156,12 +20133,10 @@ paths:
         in: query
         schema:
           type: string
-        description: name parameter
       - name: label
         in: query
         schema:
           type: string
-        description: label parameter
       requestBody:
         content:
           "*/*":
@@ -20431,7 +20406,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: sha
-        description: sha parameter
         in: path
         required: true
         schema:
@@ -20687,7 +20661,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: ref
-        description: ref parameter
         in: path
         required: true
         schema:
@@ -20978,7 +20951,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: ref
-        description: ref parameter
         in: path
         required: true
         schema:
@@ -21017,13 +20989,11 @@ paths:
         url: https://developer.github.com/enterprise/2.20/v3/repos/#create-a-repository-using-a-template
       parameters:
       - name: template_owner
-        description: template_owner parameter
         in: path
         required: true
         schema:
           type: string
       - name: template_repo
-        description: template_repo parameter
         in: path
         required: true
         schema:
@@ -24713,12 +24683,7 @@ paths:
         url: https://developer.github.com/enterprise/2.20/v3/apps/installations/#add-a-repository-to-an-app-installation
       parameters:
       - "$ref": "#/components/parameters/installation_id"
-      - name: repository_id
-        description: repository_id parameter
-        in: path
-        required: true
-        schema:
-          type: integer
+      - "$ref": "#/components/parameters/repository_id"
       responses:
         '204':
           description: Empty response
@@ -24748,12 +24713,7 @@ paths:
         url: https://developer.github.com/enterprise/2.20/v3/apps/installations/#remove-a-repository-from-an-app-installation
       parameters:
       - "$ref": "#/components/parameters/installation_id"
-      - name: repository_id
-        description: repository_id parameter
-        in: path
-        required: true
-        schema:
-          type: integer
+      - "$ref": "#/components/parameters/repository_id"
       responses:
         '204':
           description: Empty response
@@ -26163,7 +26123,6 @@ paths:
       parameters:
       - "$ref": "#/components/parameters/username"
       - name: target_user
-        description: target_user parameter
         in: path
         required: true
         schema:
@@ -26938,6 +26897,12 @@ components:
       required: true
       schema:
         type: string
+    app_slug:
+      name: app_slug
+      in: path
+      required: true
+      schema:
+        type: string
     authorization_id:
       name: authorization_id
       description: authorization_id parameter
@@ -27208,6 +27173,12 @@ components:
       required: true
       schema:
         type: integer
+    repository_id:
+      name: repository_id
+      in: path
+      required: true
+      schema:
+        type: integer
   schemas:
     global-hook:
       type: object
diff --git a/descriptions/ghes-2.21/dereferenced/ghes-2.21.deref.json b/descriptions/ghes-2.21/dereferenced/ghes-2.21.deref.json
index 2d0fb2a06..a17057f32 100644
--- a/descriptions/ghes-2.21/dereferenced/ghes-2.21.deref.json
+++ b/descriptions/ghes-2.21/dereferenced/ghes-2.21.deref.json
@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "0.0.7",
+    "version": "1.0.0-rc.1",
     "title": "GitHub v3 REST API",
     "description": "GitHub's v3 REST API.",
     "license": {
@@ -5156,7 +5156,6 @@
         "parameters": [
           {
             "name": "code",
-            "description": "code parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -11272,7 +11271,6 @@
         "parameters": [
           {
             "name": "app_slug",
-            "description": "app_slug parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -13841,7 +13839,6 @@
           },
           {
             "name": "fingerprint",
-            "description": "fingerprint parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -16066,7 +16063,6 @@
         "parameters": [
           {
             "name": "key",
-            "description": "key parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -16204,7 +16200,6 @@
         "parameters": [
           {
             "name": "content_reference_id",
-            "description": "content_reference_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -27149,7 +27144,6 @@
           },
           {
             "name": "sha",
-            "description": "sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -28010,7 +28004,6 @@
         "parameters": [
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -32165,7 +32158,6 @@
         "parameters": [
           {
             "name": "license",
-            "description": "license parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -76130,7 +76122,6 @@
           },
           {
             "name": "assignee",
-            "description": "assignee parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -107702,7 +107693,6 @@
           },
           {
             "name": "base",
-            "description": "base parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -107711,7 +107701,6 @@
           },
           {
             "name": "head",
-            "description": "head parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -115215,7 +115204,6 @@
           },
           {
             "name": "status_id",
-            "description": "status_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -120854,7 +120842,6 @@
           },
           {
             "name": "file_sha",
-            "description": "file_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -122861,7 +122848,6 @@
           },
           {
             "name": "tag_sha",
-            "description": "tag_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -123423,7 +123409,6 @@
           },
           {
             "name": "tree_sha",
-            "description": "tree_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -139091,7 +139076,6 @@
           },
           {
             "name": "event_id",
-            "description": "event_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -154234,7 +154218,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -156788,7 +156771,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -156926,7 +156908,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -157072,7 +157053,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -160981,6 +160961,7 @@
                 "properties": {
                   "source": {
                     "type": "object",
+                    "description": "The source branch and directory used to publish your Pages site.",
                     "properties": {
                       "branch": {
                         "type": "string",
@@ -162257,7 +162238,6 @@
           },
           {
             "name": "build_id",
-            "description": "build_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -195066,16 +195046,14 @@
             "in": "query",
             "schema": {
               "type": "string"
-            },
-            "description": "name parameter"
+            }
           },
           {
             "name": "label",
             "in": "query",
             "schema": {
               "type": "string"
-            },
-            "description": "label parameter"
+            }
           }
         ],
         "requestBody": {
@@ -196532,7 +196510,6 @@
           },
           {
             "name": "sha",
-            "description": "sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -197481,7 +197458,6 @@
           },
           {
             "name": "ref",
-            "description": "ref parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -199351,7 +199327,6 @@
           },
           {
             "name": "ref",
-            "description": "ref parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -199398,7 +199373,6 @@
         "parameters": [
           {
             "name": "template_owner",
-            "description": "template_owner parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -199407,7 +199381,6 @@
           },
           {
             "name": "template_repo",
-            "description": "template_repo parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -224540,7 +224513,6 @@
           },
           {
             "name": "repository_id",
-            "description": "repository_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -224629,7 +224601,6 @@
           },
           {
             "name": "repository_id",
-            "description": "repository_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -247325,7 +247296,6 @@
           },
           {
             "name": "target_user",
-            "description": "target_user parameter",
             "in": "path",
             "required": true,
             "schema": {
diff --git a/descriptions/ghes-2.21/dereferenced/ghes-2.21.deref.yaml b/descriptions/ghes-2.21/dereferenced/ghes-2.21.deref.yaml
index 79248a74b..9211dc62d 100644
--- a/descriptions/ghes-2.21/dereferenced/ghes-2.21.deref.yaml
+++ b/descriptions/ghes-2.21/dereferenced/ghes-2.21.deref.yaml
@@ -1,7 +1,7 @@
 ---
 openapi: 3.0.3
 info:
-  version: 0.0.7
+  version: 1.0.0-rc.1
   title: GitHub v3 REST API
   description: GitHub's v3 REST API.
   license:
@@ -3828,7 +3828,6 @@ paths:
         url: https://developer.github.com/enterprise/2.21/v3/apps/#create-a-github-app-from-a-manifest
       parameters:
       - name: code
-        description: code parameter
         in: path
         required: true
         schema:
@@ -8512,7 +8511,6 @@ paths:
         url: https://developer.github.com/enterprise/2.21/v3/apps/#get-an-app
       parameters:
       - name: app_slug
-        description: app_slug parameter
         in: path
         required: true
         schema:
@@ -10496,7 +10494,6 @@ paths:
         schema:
           type: string
       - name: fingerprint
-        description: fingerprint parameter
         in: path
         required: true
         schema:
@@ -12245,7 +12242,6 @@ paths:
         url: https://developer.github.com/enterprise/2.21/v3/codes_of_conduct/#get-a-code-of-conduct
       parameters:
       - name: key
-        description: key parameter
         in: path
         required: true
         schema:
@@ -12447,7 +12443,6 @@ paths:
         url: https://developer.github.com/enterprise/2.21/v3/apps/installations/#create-a-content-attachment
       parameters:
       - name: content_reference_id
-        description: content_reference_id parameter
         in: path
         required: true
         schema:
@@ -20519,7 +20514,6 @@ paths:
         schema:
           type: string
       - name: sha
-        description: sha parameter
         in: path
         required: true
         schema:
@@ -21128,7 +21122,6 @@ paths:
         url: https://developer.github.com/enterprise/2.21/v3/gitignore/#get-a-gitignore-template
       parameters:
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -24390,7 +24383,6 @@ paths:
         url: https://developer.github.com/enterprise/2.21/v3/licenses/#get-a-license
       parameters:
       - name: license
-        description: license parameter
         in: path
         required: true
         schema:
@@ -58450,7 +58442,6 @@ paths:
         schema:
           type: string
       - name: assignee
-        description: assignee parameter
         in: path
         required: true
         schema:
@@ -82859,13 +82850,11 @@ paths:
         schema:
           type: string
       - name: base
-        description: base parameter
         in: path
         required: true
         schema:
           type: string
       - name: head
-        description: head parameter
         in: path
         required: true
         schema:
@@ -88695,7 +88684,6 @@ paths:
         schema:
           type: integer
       - name: status_id
-        description: status_id parameter
         in: path
         required: true
         schema:
@@ -93026,7 +93014,6 @@ paths:
         schema:
           type: string
       - name: file_sha
-        description: file_sha parameter
         in: path
         required: true
         schema:
@@ -94544,7 +94531,6 @@ paths:
         schema:
           type: string
       - name: tag_sha
-        description: tag_sha parameter
         in: path
         required: true
         schema:
@@ -94952,7 +94938,6 @@ paths:
         schema:
           type: string
       - name: tree_sha
-        description: tree_sha parameter
         in: path
         required: true
         schema:
@@ -107016,7 +107001,6 @@ paths:
         schema:
           type: string
       - name: event_id
-        description: event_id parameter
         in: path
         required: true
         schema:
@@ -118724,7 +118708,6 @@ paths:
         schema:
           type: integer
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -120568,7 +120551,6 @@ paths:
         schema:
           type: string
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -120668,7 +120650,6 @@ paths:
         schema:
           type: string
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -120779,7 +120760,6 @@ paths:
         schema:
           type: string
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -123747,6 +123727,8 @@ paths:
               properties:
                 source:
                   type: object
+                  description: The source branch and directory used to publish your
+                    Pages site.
                   properties:
                     branch:
                       type: string
@@ -124660,7 +124642,6 @@ paths:
         schema:
           type: string
       - name: build_id
-        description: build_id parameter
         in: path
         required: true
         schema:
@@ -150386,12 +150367,10 @@ paths:
         in: query
         schema:
           type: string
-        description: name parameter
       - name: label
         in: query
         schema:
           type: string
-        description: label parameter
       requestBody:
         content:
           "*/*":
@@ -151502,7 +151481,6 @@ paths:
         schema:
           type: string
       - name: sha
-        description: sha parameter
         in: path
         required: true
         schema:
@@ -152214,7 +152192,6 @@ paths:
         schema:
           type: string
       - name: ref
-        description: ref parameter
         in: path
         required: true
         schema:
@@ -153627,7 +153604,6 @@ paths:
         schema:
           type: string
       - name: ref
-        description: ref parameter
         in: path
         required: true
         schema:
@@ -153666,13 +153642,11 @@ paths:
         url: https://developer.github.com/enterprise/2.21/v3/repos/#create-a-repository-using-a-template
       parameters:
       - name: template_owner
-        description: template_owner parameter
         in: path
         required: true
         schema:
           type: string
       - name: template_repo
-        description: template_repo parameter
         in: path
         required: true
         schema:
@@ -172919,7 +172893,6 @@ paths:
         schema:
           type: integer
       - name: repository_id
-        description: repository_id parameter
         in: path
         required: true
         schema:
@@ -172981,7 +172954,6 @@ paths:
         schema:
           type: integer
       - name: repository_id
-        description: repository_id parameter
         in: path
         required: true
         schema:
@@ -190403,7 +190375,6 @@ paths:
         schema:
           type: string
       - name: target_user
-        description: target_user parameter
         in: path
         required: true
         schema:
diff --git a/descriptions/ghes-2.21/ghes-2.21.json b/descriptions/ghes-2.21/ghes-2.21.json
index 1ea035b33..6f26c0756 100644
--- a/descriptions/ghes-2.21/ghes-2.21.json
+++ b/descriptions/ghes-2.21/ghes-2.21.json
@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "0.0.7",
+    "version": "1.0.0-rc.1",
     "title": "GitHub v3 REST API",
     "description": "GitHub's v3 REST API.",
     "license": {
@@ -2518,7 +2518,6 @@
         "parameters": [
           {
             "name": "code",
-            "description": "code parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -3464,13 +3463,7 @@
         },
         "parameters": [
           {
-            "name": "app_slug",
-            "description": "app_slug parameter",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
-            }
+            "$ref": "#/components/parameters/app_slug"
           }
         ],
         "responses": {
@@ -3847,7 +3840,6 @@
           },
           {
             "name": "fingerprint",
-            "description": "fingerprint parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -4230,7 +4222,6 @@
         "parameters": [
           {
             "name": "key",
-            "description": "key parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -4294,7 +4285,6 @@
         "parameters": [
           {
             "name": "content_reference_id",
-            "description": "content_reference_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -5799,7 +5789,6 @@
           },
           {
             "name": "sha",
-            "description": "sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -5912,7 +5901,6 @@
         "parameters": [
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -6294,7 +6282,6 @@
         "parameters": [
           {
             "name": "license",
-            "description": "license parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -13819,7 +13806,6 @@
           },
           {
             "name": "assignee",
-            "description": "assignee parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -18882,7 +18868,6 @@
           },
           {
             "name": "base",
-            "description": "base parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -18891,7 +18876,6 @@
           },
           {
             "name": "head",
-            "description": "head parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -20065,7 +20049,6 @@
           },
           {
             "name": "status_id",
-            "description": "status_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -20437,7 +20420,6 @@
           },
           {
             "name": "file_sha",
-            "description": "file_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -21182,7 +21164,6 @@
           },
           {
             "name": "tag_sha",
-            "description": "tag_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -21378,7 +21359,6 @@
           },
           {
             "name": "tree_sha",
-            "description": "tree_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -23069,7 +23049,6 @@
           },
           {
             "name": "event_id",
-            "description": "event_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -24023,7 +24002,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -24917,7 +24895,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -24975,7 +24952,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -25058,7 +25034,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -25979,6 +25954,7 @@
                 "properties": {
                   "source": {
                     "type": "object",
+                    "description": "The source branch and directory used to publish your Pages site.",
                     "properties": {
                       "branch": {
                         "type": "string",
@@ -26378,7 +26354,6 @@
           },
           {
             "name": "build_id",
-            "description": "build_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -30154,16 +30129,14 @@
             "in": "query",
             "schema": {
               "type": "string"
-            },
-            "description": "name parameter"
+            }
           },
           {
             "name": "label",
             "in": "query",
             "schema": {
               "type": "string"
-            },
-            "description": "label parameter"
+            }
           }
         ],
         "requestBody": {
@@ -30558,7 +30531,6 @@
           },
           {
             "name": "sha",
-            "description": "sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -30943,7 +30915,6 @@
           },
           {
             "name": "ref",
-            "description": "ref parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -31359,7 +31330,6 @@
           },
           {
             "name": "ref",
-            "description": "ref parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -31406,7 +31376,6 @@
         "parameters": [
           {
             "name": "template_owner",
-            "description": "template_owner parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -31415,7 +31384,6 @@
           },
           {
             "name": "template_repo",
-            "description": "template_repo parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -36201,13 +36169,7 @@
             "$ref": "#/components/parameters/installation_id"
           },
           {
-            "name": "repository_id",
-            "description": "repository_id parameter",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "integer"
-            }
+            "$ref": "#/components/parameters/repository_id"
           }
         ],
         "responses": {
@@ -36250,13 +36212,7 @@
             "$ref": "#/components/parameters/installation_id"
           },
           {
-            "name": "repository_id",
-            "description": "repository_id parameter",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "integer"
-            }
+            "$ref": "#/components/parameters/repository_id"
           }
         ],
         "responses": {
@@ -38329,7 +38285,6 @@
           },
           {
             "name": "target_user",
-            "description": "target_user parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -39469,6 +39424,14 @@
           "type": "string"
         }
       },
+      "app_slug": {
+        "name": "app_slug",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "type": "string"
+        }
+      },
       "authorization_id": {
         "name": "authorization_id",
         "description": "authorization_id parameter",
@@ -39807,6 +39770,14 @@
         "schema": {
           "type": "integer"
         }
+      },
+      "repository_id": {
+        "name": "repository_id",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "type": "integer"
+        }
       }
     },
     "schemas": {
diff --git a/descriptions/ghes-2.21/ghes-2.21.yaml b/descriptions/ghes-2.21/ghes-2.21.yaml
index 592afb219..ec1f96050 100644
--- a/descriptions/ghes-2.21/ghes-2.21.yaml
+++ b/descriptions/ghes-2.21/ghes-2.21.yaml
@@ -1,7 +1,7 @@
 ---
 openapi: 3.0.3
 info:
-  version: 0.0.7
+  version: 1.0.0-rc.1
   title: GitHub v3 REST API
   description: GitHub's v3 REST API.
   license:
@@ -1819,7 +1819,6 @@ paths:
         url: https://developer.github.com/enterprise/2.21/v3/apps/#create-a-github-app-from-a-manifest
       parameters:
       - name: code
-        description: code parameter
         in: path
         required: true
         schema:
@@ -2482,12 +2481,7 @@ paths:
         description: API method documentation
         url: https://developer.github.com/enterprise/2.21/v3/apps/#get-an-app
       parameters:
-      - name: app_slug
-        description: app_slug parameter
-        in: path
-        required: true
-        schema:
-          type: string
+      - "$ref": "#/components/parameters/app_slug"
       responses:
         '200':
           description: response
@@ -2778,7 +2772,6 @@ paths:
       parameters:
       - "$ref": "#/components/parameters/client-id"
       - name: fingerprint
-        description: fingerprint parameter
         in: path
         required: true
         schema:
@@ -3057,7 +3050,6 @@ paths:
         url: https://developer.github.com/enterprise/2.21/v3/codes_of_conduct/#get-a-code-of-conduct
       parameters:
       - name: key
-        description: key parameter
         in: path
         required: true
         schema:
@@ -3110,7 +3102,6 @@ paths:
         url: https://developer.github.com/enterprise/2.21/v3/apps/installations/#create-a-content-attachment
       parameters:
       - name: content_reference_id
-        description: content_reference_id parameter
         in: path
         required: true
         schema:
@@ -4099,7 +4090,6 @@ paths:
       parameters:
       - "$ref": "#/components/parameters/gist_id"
       - name: sha
-        description: sha parameter
         in: path
         required: true
         schema:
@@ -4177,7 +4167,6 @@ paths:
         url: https://developer.github.com/enterprise/2.21/v3/gitignore/#get-a-gitignore-template
       parameters:
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -4456,7 +4445,6 @@ paths:
         url: https://developer.github.com/enterprise/2.21/v3/licenses/#get-a-license
       parameters:
       - name: license
-        description: license parameter
         in: path
         required: true
         schema:
@@ -9980,7 +9968,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: assignee
-        description: assignee parameter
         in: path
         required: true
         schema:
@@ -13762,13 +13749,11 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: base
-        description: base parameter
         in: path
         required: true
         schema:
           type: string
       - name: head
-        description: head parameter
         in: path
         required: true
         schema:
@@ -14718,7 +14703,6 @@ paths:
       - "$ref": "#/components/parameters/repo"
       - "$ref": "#/components/parameters/deployment_id"
       - name: status_id
-        description: status_id parameter
         in: path
         required: true
         schema:
@@ -14967,7 +14951,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: file_sha
-        description: file_sha parameter
         in: path
         required: true
         schema:
@@ -15597,7 +15580,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: tag_sha
-        description: tag_sha parameter
         in: path
         required: true
         schema:
@@ -15745,7 +15727,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: tree_sha
-        description: tree_sha parameter
         in: path
         required: true
         schema:
@@ -16915,7 +16896,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: event_id
-        description: event_id parameter
         in: path
         required: true
         schema:
@@ -17561,7 +17541,6 @@ paths:
       - "$ref": "#/components/parameters/repo"
       - "$ref": "#/components/parameters/issue_number"
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -18165,7 +18144,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -18201,7 +18179,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -18259,7 +18236,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -18851,6 +18827,8 @@ paths:
               properties:
                 source:
                   type: object
+                  description: The source branch and directory used to publish your
+                    Pages site.
                   properties:
                     branch:
                       type: string
@@ -19120,7 +19098,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: build_id
-        description: build_id parameter
         in: path
         required: true
         schema:
@@ -21860,12 +21837,10 @@ paths:
         in: query
         schema:
           type: string
-        description: name parameter
       - name: label
         in: query
         schema:
           type: string
-        description: label parameter
       requestBody:
         content:
           "*/*":
@@ -22135,7 +22110,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: sha
-        description: sha parameter
         in: path
         required: true
         schema:
@@ -22391,7 +22365,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: ref
-        description: ref parameter
         in: path
         required: true
         schema:
@@ -22682,7 +22655,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: ref
-        description: ref parameter
         in: path
         required: true
         schema:
@@ -22721,13 +22693,11 @@ paths:
         url: https://developer.github.com/enterprise/2.21/v3/repos/#create-a-repository-using-a-template
       parameters:
       - name: template_owner
-        description: template_owner parameter
         in: path
         required: true
         schema:
           type: string
       - name: template_repo
-        description: template_repo parameter
         in: path
         required: true
         schema:
@@ -26300,12 +26270,7 @@ paths:
         url: https://developer.github.com/enterprise/2.21/v3/apps/installations/#add-a-repository-to-an-app-installation
       parameters:
       - "$ref": "#/components/parameters/installation_id"
-      - name: repository_id
-        description: repository_id parameter
-        in: path
-        required: true
-        schema:
-          type: integer
+      - "$ref": "#/components/parameters/repository_id"
       responses:
         '204':
           description: Empty response
@@ -26335,12 +26300,7 @@ paths:
         url: https://developer.github.com/enterprise/2.21/v3/apps/installations/#remove-a-repository-from-an-app-installation
       parameters:
       - "$ref": "#/components/parameters/installation_id"
-      - name: repository_id
-        description: repository_id parameter
-        in: path
-        required: true
-        schema:
-          type: integer
+      - "$ref": "#/components/parameters/repository_id"
       responses:
         '204':
           description: Empty response
@@ -27750,7 +27710,6 @@ paths:
       parameters:
       - "$ref": "#/components/parameters/username"
       - name: target_user
-        description: target_user parameter
         in: path
         required: true
         schema:
@@ -28525,6 +28484,12 @@ components:
       required: true
       schema:
         type: string
+    app_slug:
+      name: app_slug
+      in: path
+      required: true
+      schema:
+        type: string
     authorization_id:
       name: authorization_id
       description: authorization_id parameter
@@ -28795,6 +28760,12 @@ components:
       required: true
       schema:
         type: integer
+    repository_id:
+      name: repository_id
+      in: path
+      required: true
+      schema:
+        type: integer
   schemas:
     global-hook:
       type: object
diff --git a/descriptions/ghes-2.22/dereferenced/ghes-2.22.deref.json b/descriptions/ghes-2.22/dereferenced/ghes-2.22.deref.json
index 74218d892..595126cb7 100644
--- a/descriptions/ghes-2.22/dereferenced/ghes-2.22.deref.json
+++ b/descriptions/ghes-2.22/dereferenced/ghes-2.22.deref.json
@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "0.0.7",
+    "version": "1.0.0-rc.1",
     "title": "GitHub v3 REST API",
     "description": "GitHub's v3 REST API.",
     "license": {
@@ -5156,7 +5156,6 @@
         "parameters": [
           {
             "name": "code",
-            "description": "code parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -11272,7 +11271,6 @@
         "parameters": [
           {
             "name": "app_slug",
-            "description": "app_slug parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -13841,7 +13839,6 @@
           },
           {
             "name": "fingerprint",
-            "description": "fingerprint parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -16066,7 +16063,6 @@
         "parameters": [
           {
             "name": "key",
-            "description": "key parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -16204,7 +16200,6 @@
         "parameters": [
           {
             "name": "content_reference_id",
-            "description": "content_reference_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -31035,7 +31030,6 @@
           },
           {
             "name": "sha",
-            "description": "sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -31896,7 +31890,6 @@
         "parameters": [
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -36051,7 +36044,6 @@
         "parameters": [
           {
             "name": "license",
-            "description": "license parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -48745,7 +48737,6 @@
           },
           {
             "name": "repository_id",
-            "description": "repository_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -48802,7 +48793,6 @@
           },
           {
             "name": "repository_id",
-            "description": "repository_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -86347,7 +86337,6 @@
           },
           {
             "name": "archive_format",
-            "description": "archive_format parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -89208,7 +89197,7 @@
     "/repos/{owner}/{repo}/actions/runners/{runner_id}": {
       "get": {
         "summary": "Get a self-hosted runner for a repository",
-        "description": "Gets a specific self-hosted runner configured in a repository.\n\nYou must authenticate using an access token with the `repo` scope to use this",
+        "description": "Gets a specific self-hosted runner configured in a repository.\n\nYou must authenticate using an access token with the `repo` scope to use this\nendpoint.",
         "tags": [
           "actions"
         ],
@@ -89360,7 +89349,7 @@
       },
       "delete": {
         "summary": "Delete a self-hosted runner from a repository",
-        "description": "Forces the removal of a self-hosted runner from a repository. You can use this endpoint to completely remove the runner when the machine you were using no longer exists.\n\nYou must authenticate using an access token with the `repo`",
+        "description": "Forces the removal of a self-hosted runner from a repository. You can use this endpoint to completely remove the runner when the machine you were using no longer exists.\n\nYou must authenticate using an access token with the `repo`\nscope to use this endpoint.",
         "tags": [
           "actions"
         ],
@@ -96243,7 +96232,6 @@
           },
           {
             "name": "assignee",
-            "description": "assignee parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -115161,7 +115149,6 @@
           },
           {
             "name": "alert_number",
-            "description": "alert_number parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -116203,7 +116190,7 @@
           "previews": [
 
           ],
-          "category": "code-scanning."
+          "category": "code-scanning"
         }
       }
     },
@@ -129304,7 +129291,6 @@
           },
           {
             "name": "base",
-            "description": "base parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -129313,7 +129299,6 @@
           },
           {
             "name": "head",
-            "description": "head parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -136817,7 +136802,6 @@
           },
           {
             "name": "status_id",
-            "description": "status_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -142456,7 +142440,6 @@
           },
           {
             "name": "file_sha",
-            "description": "file_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -144463,7 +144446,6 @@
           },
           {
             "name": "tag_sha",
-            "description": "tag_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -145025,7 +145007,6 @@
           },
           {
             "name": "tree_sha",
-            "description": "tree_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -160693,7 +160674,6 @@
           },
           {
             "name": "event_id",
-            "description": "event_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -175836,7 +175816,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -178390,7 +178369,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -178528,7 +178506,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -178674,7 +178651,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -182583,6 +182559,7 @@
                 "properties": {
                   "source": {
                     "type": "object",
+                    "description": "The source branch and directory used to publish your Pages site.",
                     "properties": {
                       "branch": {
                         "type": "string",
@@ -183859,7 +183836,6 @@
           },
           {
             "name": "build_id",
-            "description": "build_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -216668,16 +216644,14 @@
             "in": "query",
             "schema": {
               "type": "string"
-            },
-            "description": "name parameter"
+            }
           },
           {
             "name": "label",
             "in": "query",
             "schema": {
               "type": "string"
-            },
-            "description": "label parameter"
+            }
           }
         ],
         "requestBody": {
@@ -218134,7 +218108,6 @@
           },
           {
             "name": "sha",
-            "description": "sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -219083,7 +219056,6 @@
           },
           {
             "name": "ref",
-            "description": "ref parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -220953,7 +220925,6 @@
           },
           {
             "name": "ref",
-            "description": "ref parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -221000,7 +220971,6 @@
         "parameters": [
           {
             "name": "template_owner",
-            "description": "template_owner parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -221009,7 +220979,6 @@
           },
           {
             "name": "template_repo",
-            "description": "template_repo parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -246142,7 +246111,6 @@
           },
           {
             "name": "repository_id",
-            "description": "repository_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -246231,7 +246199,6 @@
           },
           {
             "name": "repository_id",
-            "description": "repository_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -268927,7 +268894,6 @@
           },
           {
             "name": "target_user",
-            "description": "target_user parameter",
             "in": "path",
             "required": true,
             "schema": {
diff --git a/descriptions/ghes-2.22/dereferenced/ghes-2.22.deref.yaml b/descriptions/ghes-2.22/dereferenced/ghes-2.22.deref.yaml
index 672e3f3fc..ac028da37 100644
--- a/descriptions/ghes-2.22/dereferenced/ghes-2.22.deref.yaml
+++ b/descriptions/ghes-2.22/dereferenced/ghes-2.22.deref.yaml
@@ -1,7 +1,7 @@
 ---
 openapi: 3.0.3
 info:
-  version: 0.0.7
+  version: 1.0.0-rc.1
   title: GitHub v3 REST API
   description: GitHub's v3 REST API.
   license:
@@ -3828,7 +3828,6 @@ paths:
         url: https://developer.github.com/enterprise/2.22/v3/apps/#create-a-github-app-from-a-manifest
       parameters:
       - name: code
-        description: code parameter
         in: path
         required: true
         schema:
@@ -8512,7 +8511,6 @@ paths:
         url: https://developer.github.com/enterprise/2.22/v3/apps/#get-an-app
       parameters:
       - name: app_slug
-        description: app_slug parameter
         in: path
         required: true
         schema:
@@ -10496,7 +10494,6 @@ paths:
         schema:
           type: string
       - name: fingerprint
-        description: fingerprint parameter
         in: path
         required: true
         schema:
@@ -12245,7 +12242,6 @@ paths:
         url: https://developer.github.com/enterprise/2.22/v3/codes_of_conduct/#get-a-code-of-conduct
       parameters:
       - name: key
-        description: key parameter
         in: path
         required: true
         schema:
@@ -12447,7 +12443,6 @@ paths:
         url: https://developer.github.com/enterprise/2.22/v3/apps/installations/#create-a-content-attachment
       parameters:
       - name: content_reference_id
-        description: content_reference_id parameter
         in: path
         required: true
         schema:
@@ -23391,7 +23386,6 @@ paths:
         schema:
           type: string
       - name: sha
-        description: sha parameter
         in: path
         required: true
         schema:
@@ -24000,7 +23994,6 @@ paths:
         url: https://developer.github.com/enterprise/2.22/v3/gitignore/#get-a-gitignore-template
       parameters:
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -27262,7 +27255,6 @@ paths:
         url: https://developer.github.com/enterprise/2.22/v3/licenses/#get-a-license
       parameters:
       - name: license
-        description: license parameter
         in: path
         required: true
         schema:
@@ -37057,7 +37049,6 @@ paths:
         schema:
           type: string
       - name: repository_id
-        description: repository_id parameter
         in: path
         required: true
         schema:
@@ -37100,7 +37091,6 @@ paths:
         schema:
           type: string
       - name: repository_id
-        description: repository_id parameter
         in: path
         required: true
         schema:
@@ -66171,7 +66161,6 @@ paths:
         schema:
           type: integer
       - name: archive_format
-        description: archive_format parameter
         in: path
         required: true
         schema:
@@ -68313,6 +68302,7 @@ paths:
         Gets a specific self-hosted runner configured in a repository.
 
         You must authenticate using an access token with the `repo` scope to use this
+        endpoint.
       tags:
       - actions
       operationId: actions/get-self-hosted-runner-for-repo
@@ -68422,6 +68412,7 @@ paths:
         Forces the removal of a self-hosted runner from a repository. You can use this endpoint to completely remove the runner when the machine you were using no longer exists.
 
         You must authenticate using an access token with the `repo`
+        scope to use this endpoint.
       tags:
       - actions
       operationId: actions/delete-self-hosted-runner-from-repo
@@ -73792,7 +73783,6 @@ paths:
         schema:
           type: string
       - name: assignee
-        description: assignee parameter
         in: path
         required: true
         schema:
@@ -88260,7 +88250,6 @@ paths:
         schema:
           type: string
       - name: alert_number
-        description: alert_number parameter
         in: path
         required: true
         schema:
@@ -89076,7 +89065,7 @@ paths:
         enabledForApps: true
         githubCloudOnly: false
         previews: []
-        category: code-scanning.
+        category: code-scanning
   "/repos/{owner}/{repo}/collaborators":
     get:
       summary: List repository collaborators
@@ -99366,13 +99355,11 @@ paths:
         schema:
           type: string
       - name: base
-        description: base parameter
         in: path
         required: true
         schema:
           type: string
       - name: head
-        description: head parameter
         in: path
         required: true
         schema:
@@ -105202,7 +105189,6 @@ paths:
         schema:
           type: integer
       - name: status_id
-        description: status_id parameter
         in: path
         required: true
         schema:
@@ -109533,7 +109519,6 @@ paths:
         schema:
           type: string
       - name: file_sha
-        description: file_sha parameter
         in: path
         required: true
         schema:
@@ -111051,7 +111036,6 @@ paths:
         schema:
           type: string
       - name: tag_sha
-        description: tag_sha parameter
         in: path
         required: true
         schema:
@@ -111459,7 +111443,6 @@ paths:
         schema:
           type: string
       - name: tree_sha
-        description: tree_sha parameter
         in: path
         required: true
         schema:
@@ -123523,7 +123506,6 @@ paths:
         schema:
           type: string
       - name: event_id
-        description: event_id parameter
         in: path
         required: true
         schema:
@@ -135231,7 +135213,6 @@ paths:
         schema:
           type: integer
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -137075,7 +137056,6 @@ paths:
         schema:
           type: string
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -137175,7 +137155,6 @@ paths:
         schema:
           type: string
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -137286,7 +137265,6 @@ paths:
         schema:
           type: string
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -140254,6 +140232,8 @@ paths:
               properties:
                 source:
                   type: object
+                  description: The source branch and directory used to publish your
+                    Pages site.
                   properties:
                     branch:
                       type: string
@@ -141167,7 +141147,6 @@ paths:
         schema:
           type: string
       - name: build_id
-        description: build_id parameter
         in: path
         required: true
         schema:
@@ -166893,12 +166872,10 @@ paths:
         in: query
         schema:
           type: string
-        description: name parameter
       - name: label
         in: query
         schema:
           type: string
-        description: label parameter
       requestBody:
         content:
           "*/*":
@@ -168009,7 +167986,6 @@ paths:
         schema:
           type: string
       - name: sha
-        description: sha parameter
         in: path
         required: true
         schema:
@@ -168721,7 +168697,6 @@ paths:
         schema:
           type: string
       - name: ref
-        description: ref parameter
         in: path
         required: true
         schema:
@@ -170134,7 +170109,6 @@ paths:
         schema:
           type: string
       - name: ref
-        description: ref parameter
         in: path
         required: true
         schema:
@@ -170173,13 +170147,11 @@ paths:
         url: https://developer.github.com/enterprise/2.22/v3/repos/#create-a-repository-using-a-template
       parameters:
       - name: template_owner
-        description: template_owner parameter
         in: path
         required: true
         schema:
           type: string
       - name: template_repo
-        description: template_repo parameter
         in: path
         required: true
         schema:
@@ -189426,7 +189398,6 @@ paths:
         schema:
           type: integer
       - name: repository_id
-        description: repository_id parameter
         in: path
         required: true
         schema:
@@ -189488,7 +189459,6 @@ paths:
         schema:
           type: integer
       - name: repository_id
-        description: repository_id parameter
         in: path
         required: true
         schema:
@@ -206910,7 +206880,6 @@ paths:
         schema:
           type: string
       - name: target_user
-        description: target_user parameter
         in: path
         required: true
         schema:
diff --git a/descriptions/ghes-2.22/ghes-2.22.json b/descriptions/ghes-2.22/ghes-2.22.json
index 86222dd86..0216d31ba 100644
--- a/descriptions/ghes-2.22/ghes-2.22.json
+++ b/descriptions/ghes-2.22/ghes-2.22.json
@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "0.0.7",
+    "version": "1.0.0-rc.1",
     "title": "GitHub v3 REST API",
     "description": "GitHub's v3 REST API.",
     "license": {
@@ -2518,7 +2518,6 @@
         "parameters": [
           {
             "name": "code",
-            "description": "code parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -3464,13 +3463,7 @@
         },
         "parameters": [
           {
-            "name": "app_slug",
-            "description": "app_slug parameter",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
-            }
+            "$ref": "#/components/parameters/app_slug"
           }
         ],
         "responses": {
@@ -3847,7 +3840,6 @@
           },
           {
             "name": "fingerprint",
-            "description": "fingerprint parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -4230,7 +4222,6 @@
         "parameters": [
           {
             "name": "key",
-            "description": "key parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -4294,7 +4285,6 @@
         "parameters": [
           {
             "name": "content_reference_id",
-            "description": "content_reference_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -6812,7 +6802,6 @@
           },
           {
             "name": "sha",
-            "description": "sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -6925,7 +6914,6 @@
         "parameters": [
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -7307,7 +7295,6 @@
         "parameters": [
           {
             "name": "license",
-            "description": "license parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -9761,7 +9748,6 @@
           },
           {
             "name": "repository_id",
-            "description": "repository_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -9807,7 +9793,6 @@
           },
           {
             "name": "repository_id",
-            "description": "repository_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -16422,7 +16407,6 @@
           },
           {
             "name": "archive_format",
-            "description": "archive_format parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -16769,7 +16753,7 @@
     "/repos/{owner}/{repo}/actions/runners/{runner_id}": {
       "get": {
         "summary": "Get a self-hosted runner for a repository",
-        "description": "Gets a specific self-hosted runner configured in a repository.\n\nYou must authenticate using an access token with the `repo` scope to use this",
+        "description": "Gets a specific self-hosted runner configured in a repository.\n\nYou must authenticate using an access token with the `repo` scope to use this\nendpoint.",
         "tags": [
           "actions"
         ],
@@ -16818,7 +16802,7 @@
       },
       "delete": {
         "summary": "Delete a self-hosted runner from a repository",
-        "description": "Forces the removal of a self-hosted runner from a repository. You can use this endpoint to completely remove the runner when the machine you were using no longer exists.\n\nYou must authenticate using an access token with the `repo`",
+        "description": "Forces the removal of a self-hosted runner from a repository. You can use this endpoint to completely remove the runner when the machine you were using no longer exists.\n\nYou must authenticate using an access token with the `repo`\nscope to use this endpoint.",
         "tags": [
           "actions"
         ],
@@ -17979,7 +17963,6 @@
           },
           {
             "name": "assignee",
-            "description": "assignee parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -21467,7 +21450,6 @@
           },
           {
             "name": "alert_number",
-            "description": "alert_number parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -21732,7 +21714,7 @@
           "previews": [
 
           ],
-          "category": "code-scanning."
+          "category": "code-scanning"
         }
       }
     },
@@ -23407,7 +23389,6 @@
           },
           {
             "name": "base",
-            "description": "base parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -23416,7 +23397,6 @@
           },
           {
             "name": "head",
-            "description": "head parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -24590,7 +24570,6 @@
           },
           {
             "name": "status_id",
-            "description": "status_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -24962,7 +24941,6 @@
           },
           {
             "name": "file_sha",
-            "description": "file_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -25707,7 +25685,6 @@
           },
           {
             "name": "tag_sha",
-            "description": "tag_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -25903,7 +25880,6 @@
           },
           {
             "name": "tree_sha",
-            "description": "tree_sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -27594,7 +27570,6 @@
           },
           {
             "name": "event_id",
-            "description": "event_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -28548,7 +28523,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -29442,7 +29416,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -29500,7 +29473,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -29583,7 +29555,6 @@
           },
           {
             "name": "name",
-            "description": "name parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -30504,6 +30475,7 @@
                 "properties": {
                   "source": {
                     "type": "object",
+                    "description": "The source branch and directory used to publish your Pages site.",
                     "properties": {
                       "branch": {
                         "type": "string",
@@ -30903,7 +30875,6 @@
           },
           {
             "name": "build_id",
-            "description": "build_id parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -34679,16 +34650,14 @@
             "in": "query",
             "schema": {
               "type": "string"
-            },
-            "description": "name parameter"
+            }
           },
           {
             "name": "label",
             "in": "query",
             "schema": {
               "type": "string"
-            },
-            "description": "label parameter"
+            }
           }
         ],
         "requestBody": {
@@ -35083,7 +35052,6 @@
           },
           {
             "name": "sha",
-            "description": "sha parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -35468,7 +35436,6 @@
           },
           {
             "name": "ref",
-            "description": "ref parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -35884,7 +35851,6 @@
           },
           {
             "name": "ref",
-            "description": "ref parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -35931,7 +35897,6 @@
         "parameters": [
           {
             "name": "template_owner",
-            "description": "template_owner parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -35940,7 +35905,6 @@
           },
           {
             "name": "template_repo",
-            "description": "template_repo parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -40726,13 +40690,7 @@
             "$ref": "#/components/parameters/installation_id"
           },
           {
-            "name": "repository_id",
-            "description": "repository_id parameter",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "integer"
-            }
+            "$ref": "#/components/parameters/repository_id"
           }
         ],
         "responses": {
@@ -40775,13 +40733,7 @@
             "$ref": "#/components/parameters/installation_id"
           },
           {
-            "name": "repository_id",
-            "description": "repository_id parameter",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "integer"
-            }
+            "$ref": "#/components/parameters/repository_id"
           }
         ],
         "responses": {
@@ -42854,7 +42806,6 @@
           },
           {
             "name": "target_user",
-            "description": "target_user parameter",
             "in": "path",
             "required": true,
             "schema": {
@@ -43994,6 +43945,14 @@
           "type": "string"
         }
       },
+      "app_slug": {
+        "name": "app_slug",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "type": "string"
+        }
+      },
       "authorization_id": {
         "name": "authorization_id",
         "description": "authorization_id parameter",
diff --git a/descriptions/ghes-2.22/ghes-2.22.yaml b/descriptions/ghes-2.22/ghes-2.22.yaml
index e7460ebd6..97f5d13bb 100644
--- a/descriptions/ghes-2.22/ghes-2.22.yaml
+++ b/descriptions/ghes-2.22/ghes-2.22.yaml
@@ -1,7 +1,7 @@
 ---
 openapi: 3.0.3
 info:
-  version: 0.0.7
+  version: 1.0.0-rc.1
   title: GitHub v3 REST API
   description: GitHub's v3 REST API.
   license:
@@ -1819,7 +1819,6 @@ paths:
         url: https://developer.github.com/enterprise/2.22/v3/apps/#create-a-github-app-from-a-manifest
       parameters:
       - name: code
-        description: code parameter
         in: path
         required: true
         schema:
@@ -2482,12 +2481,7 @@ paths:
         description: API method documentation
         url: https://developer.github.com/enterprise/2.22/v3/apps/#get-an-app
       parameters:
-      - name: app_slug
-        description: app_slug parameter
-        in: path
-        required: true
-        schema:
-          type: string
+      - "$ref": "#/components/parameters/app_slug"
       responses:
         '200':
           description: response
@@ -2778,7 +2772,6 @@ paths:
       parameters:
       - "$ref": "#/components/parameters/client-id"
       - name: fingerprint
-        description: fingerprint parameter
         in: path
         required: true
         schema:
@@ -3057,7 +3050,6 @@ paths:
         url: https://developer.github.com/enterprise/2.22/v3/codes_of_conduct/#get-a-code-of-conduct
       parameters:
       - name: key
-        description: key parameter
         in: path
         required: true
         schema:
@@ -3110,7 +3102,6 @@ paths:
         url: https://developer.github.com/enterprise/2.22/v3/apps/installations/#create-a-content-attachment
       parameters:
       - name: content_reference_id
-        description: content_reference_id parameter
         in: path
         required: true
         schema:
@@ -4800,7 +4791,6 @@ paths:
       parameters:
       - "$ref": "#/components/parameters/gist_id"
       - name: sha
-        description: sha parameter
         in: path
         required: true
         schema:
@@ -4878,7 +4868,6 @@ paths:
         url: https://developer.github.com/enterprise/2.22/v3/gitignore/#get-a-gitignore-template
       parameters:
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -5157,7 +5146,6 @@ paths:
         url: https://developer.github.com/enterprise/2.22/v3/licenses/#get-a-license
       parameters:
       - name: license
-        description: license parameter
         in: path
         required: true
         schema:
@@ -7018,7 +7006,6 @@ paths:
       - "$ref": "#/components/parameters/org"
       - "$ref": "#/components/parameters/secret_name"
       - name: repository_id
-        description: repository_id parameter
         in: path
         required: true
         schema:
@@ -7052,7 +7039,6 @@ paths:
       - "$ref": "#/components/parameters/org"
       - "$ref": "#/components/parameters/secret_name"
       - name: repository_id
-        description: repository_id parameter
         in: path
         required: true
         schema:
@@ -11902,7 +11888,6 @@ paths:
       - "$ref": "#/components/parameters/repo"
       - "$ref": "#/components/parameters/artifact_id"
       - name: archive_format
-        description: archive_format parameter
         in: path
         required: true
         schema:
@@ -12135,6 +12120,7 @@ paths:
         Gets a specific self-hosted runner configured in a repository.
 
         You must authenticate using an access token with the `repo` scope to use this
+        endpoint.
       tags:
       - actions
       operationId: actions/get-self-hosted-runner-for-repo
@@ -12167,6 +12153,7 @@ paths:
         Forces the removal of a self-hosted runner from a repository. You can use this endpoint to completely remove the runner when the machine you were using no longer exists.
 
         You must authenticate using an access token with the `repo`
+        scope to use this endpoint.
       tags:
       - actions
       operationId: actions/delete-self-hosted-runner-from-repo
@@ -12992,7 +12979,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: assignee
-        description: assignee parameter
         in: path
         required: true
         schema:
@@ -15601,7 +15587,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: alert_number
-        description: alert_number parameter
         in: path
         required: true
         schema:
@@ -15782,7 +15767,7 @@ paths:
         enabledForApps: true
         githubCloudOnly: false
         previews: []
-        category: code-scanning.
+        category: code-scanning
   "/repos/{owner}/{repo}/collaborators":
     get:
       summary: List repository collaborators
@@ -17026,13 +17011,11 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: base
-        description: base parameter
         in: path
         required: true
         schema:
           type: string
       - name: head
-        description: head parameter
         in: path
         required: true
         schema:
@@ -17982,7 +17965,6 @@ paths:
       - "$ref": "#/components/parameters/repo"
       - "$ref": "#/components/parameters/deployment_id"
       - name: status_id
-        description: status_id parameter
         in: path
         required: true
         schema:
@@ -18231,7 +18213,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: file_sha
-        description: file_sha parameter
         in: path
         required: true
         schema:
@@ -18861,7 +18842,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: tag_sha
-        description: tag_sha parameter
         in: path
         required: true
         schema:
@@ -19009,7 +18989,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: tree_sha
-        description: tree_sha parameter
         in: path
         required: true
         schema:
@@ -20179,7 +20158,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: event_id
-        description: event_id parameter
         in: path
         required: true
         schema:
@@ -20825,7 +20803,6 @@ paths:
       - "$ref": "#/components/parameters/repo"
       - "$ref": "#/components/parameters/issue_number"
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -21429,7 +21406,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -21465,7 +21441,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -21523,7 +21498,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: name
-        description: name parameter
         in: path
         required: true
         schema:
@@ -22115,6 +22089,8 @@ paths:
               properties:
                 source:
                   type: object
+                  description: The source branch and directory used to publish your
+                    Pages site.
                   properties:
                     branch:
                       type: string
@@ -22384,7 +22360,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: build_id
-        description: build_id parameter
         in: path
         required: true
         schema:
@@ -25124,12 +25099,10 @@ paths:
         in: query
         schema:
           type: string
-        description: name parameter
       - name: label
         in: query
         schema:
           type: string
-        description: label parameter
       requestBody:
         content:
           "*/*":
@@ -25399,7 +25372,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: sha
-        description: sha parameter
         in: path
         required: true
         schema:
@@ -25655,7 +25627,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: ref
-        description: ref parameter
         in: path
         required: true
         schema:
@@ -25946,7 +25917,6 @@ paths:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
       - name: ref
-        description: ref parameter
         in: path
         required: true
         schema:
@@ -25985,13 +25955,11 @@ paths:
         url: https://developer.github.com/enterprise/2.22/v3/repos/#create-a-repository-using-a-template
       parameters:
       - name: template_owner
-        description: template_owner parameter
         in: path
         required: true
         schema:
           type: string
       - name: template_repo
-        description: template_repo parameter
         in: path
         required: true
         schema:
@@ -29564,12 +29532,7 @@ paths:
         url: https://developer.github.com/enterprise/2.22/v3/apps/installations/#add-a-repository-to-an-app-installation
       parameters:
       - "$ref": "#/components/parameters/installation_id"
-      - name: repository_id
-        description: repository_id parameter
-        in: path
-        required: true
-        schema:
-          type: integer
+      - "$ref": "#/components/parameters/repository_id"
       responses:
         '204':
           description: Empty response
@@ -29599,12 +29562,7 @@ paths:
         url: https://developer.github.com/enterprise/2.22/v3/apps/installations/#remove-a-repository-from-an-app-installation
       parameters:
       - "$ref": "#/components/parameters/installation_id"
-      - name: repository_id
-        description: repository_id parameter
-        in: path
-        required: true
-        schema:
-          type: integer
+      - "$ref": "#/components/parameters/repository_id"
       responses:
         '204':
           description: Empty response
@@ -31014,7 +30972,6 @@ paths:
       parameters:
       - "$ref": "#/components/parameters/username"
       - name: target_user
-        description: target_user parameter
         in: path
         required: true
         schema:
@@ -31789,6 +31746,12 @@ components:
       required: true
       schema:
         type: string
+    app_slug:
+      name: app_slug
+      in: path
+      required: true
+      schema:
+        type: string
     authorization_id:
       name: authorization_id
       description: authorization_id parameter