Update OpenAPI descriptions

1 files changed, 9 insertions, 93 deletions

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: