fix(typescript): description update (#318)

docs/apps/createInstallationAccessToken.md

@@ -46,20 +46,157 @@ List of repository IDs that the token should have access to
 </td></tr>
 <tr><td>permissions</td><td>no</td><td>
 
+The permissions granted to the user-to-server access token.
+
+</td></tr>
+<tr><td>permissions.actions</td><td>no</td><td>
+
+The level of permission to grant the access token for GitHub Actions workflows, workflow runs, and artifacts. Can be one of: `read` or `write`.
+
+</td></tr>
+<tr><td>permissions.administration</td><td>no</td><td>
+
+The level of permission to grant the access token for repository creation, deletion, settings, teams, and collaborators creation. Can be one of: `read` or `write`.
+
+</td></tr>
+<tr><td>permissions.checks</td><td>no</td><td>
+
+The level of permission to grant the access token for checks on code. Can be one of: `read` or `write`.
+
+</td></tr>
+<tr><td>permissions.content_references</td><td>no</td><td>
+
+The level of permission to grant the access token for notification of content references and creation content attachments. Can be one of: `read` or `write`.
+
 </td></tr>
 <tr><td>permissions.contents</td><td>no</td><td>
 
+The level of permission to grant the access token for repository contents, commits, branches, downloads, releases, and merges. Can be one of: `read` or `write`.
+
+</td></tr>
+<tr><td>permissions.deployments</td><td>no</td><td>
+
+The level of permission to grant the access token for deployments and deployment statuses. Can be one of: `read` or `write`.
+
+</td></tr>
+<tr><td>permissions.environments</td><td>no</td><td>
+
+The level of permission to grant the access token for managing repository environments. Can be one of: `read` or `write`.
+
 </td></tr>
 <tr><td>permissions.issues</td><td>no</td><td>
 
+The level of permission to grant the access token for issues and related comments, assignees, labels, and milestones. Can be one of: `read` or `write`.
+
 </td></tr>
-<tr><td>permissions.deployments</td><td>no</td><td>
+<tr><td>permissions.metadata</td><td>no</td><td>
+
+The level of permission to grant the access token to search repositories, list collaborators, and access repository metadata. Can be one of: `read` or `write`.
+
+</td></tr>
+<tr><td>permissions.packages</td><td>no</td><td>
+
+The level of permission to grant the access token for packages published to GitHub Packages. Can be one of: `read` or `write`.
+
+</td></tr>
+<tr><td>permissions.pages</td><td>no</td><td>
+
+The level of permission to grant the access token to retrieve Pages statuses, configuration, and builds, as well as create new builds. Can be one of: `read` or `write`.
+
+</td></tr>
+<tr><td>permissions.pull_requests</td><td>no</td><td>
+
+The level of permission to grant the access token for pull requests and related comments, assignees, labels, milestones, and merges. Can be one of: `read` or `write`.
+
+</td></tr>
+<tr><td>permissions.repository_hooks</td><td>no</td><td>
+
+The level of permission to grant the access token to manage the post-receive hooks for a repository. Can be one of: `read` or `write`.
+
+</td></tr>
+<tr><td>permissions.repository_projects</td><td>no</td><td>
+
+The level of permission to grant the access token to manage repository projects, columns, and cards. Can be one of: `read`, `write`, or `admin`.
+
+</td></tr>
+<tr><td>permissions.secret_scanning_alerts</td><td>no</td><td>
+
+The level of permission to grant the access token to view and manage secret scanning alerts. Can be one of: `read` or `write`.
+
+</td></tr>
+<tr><td>permissions.secrets</td><td>no</td><td>
+
+The level of permission to grant the access token to manage repository secrets. Can be one of: `read` or `write`.
+
+</td></tr>
+<tr><td>permissions.security_events</td><td>no</td><td>
+
+The level of permission to grant the access token to view and manage security events like code scanning alerts. Can be one of: `read` or `write`.
 
 </td></tr>
 <tr><td>permissions.single_file</td><td>no</td><td>
 
+The level of permission to grant the access token to manage just a single file. Can be one of: `read` or `write`.
+
 </td></tr>
-<tr><td>permissions.def_not_a_repo</td><td>no</td><td>
+<tr><td>permissions.statuses</td><td>no</td><td>
+
+The level of permission to grant the access token for commit statuses. Can be one of: `read` or `write`.
+
+</td></tr>
+<tr><td>permissions.vulnerability_alerts</td><td>no</td><td>
+
+The level of permission to grant the access token to retrieve Dependabot alerts. Can be one of: `read`.
+
+</td></tr>
+<tr><td>permissions.workflows</td><td>no</td><td>
+
+The level of permission to grant the access token to update GitHub Actions workflow files. Can be one of: `write`.
+
+</td></tr>
+<tr><td>permissions.members</td><td>no</td><td>
+
+The level of permission to grant the access token for organization teams and members. Can be one of: `read` or `write`.
+
+</td></tr>
+<tr><td>permissions.organization_administration</td><td>no</td><td>
+
+The level of permission to grant the access token to manage access to an organization. Can be one of: `read` or `write`.
+
+</td></tr>
+<tr><td>permissions.organization_hooks</td><td>no</td><td>
+
+The level of permission to grant the access token to manage the post-receive hooks for an organization. Can be one of: `read` or `write`.
+
+</td></tr>
+<tr><td>permissions.organization_plan</td><td>no</td><td>
+
+The level of permission to grant the access token for viewing an organization's plan. Can be one of: `read`.
+
+</td></tr>
+<tr><td>permissions.organization_projects</td><td>no</td><td>
+
+The level of permission to grant the access token to manage organization projects, columns, and cards. Can be one of: `read`, `write`, or `admin`.
+
+</td></tr>
+<tr><td>permissions.organization_secrets</td><td>no</td><td>
+
+The level of permission to grant the access token to manage organization secrets. Can be one of: `read` or `write`.
+
+</td></tr>
+<tr><td>permissions.organization_self_hosted_runners</td><td>no</td><td>
+
+The level of permission to grant the access token to view and manage GitHub Actions self-hosted runners available to an organization. Can be one of: `read` or `write`.
+
+</td></tr>
+<tr><td>permissions.organization_user_blocking</td><td>no</td><td>
+
+The level of permission to grant the access token to view and manage users blocked by the organization. Can be one of: `read` or `write`.
+
+</td></tr>
+<tr><td>permissions.team_discussions</td><td>no</td><td>
+
+The level of permission to grant the access token to manage team discussions and related comments. Can be one of: `read` or `write`.
 
 </td></tr>
   </tbody>

docs/meta/get.md

@@ -8,7 +8,9 @@ type: API method
 
 # Get GitHub meta information
 
-This endpoint provides a list of GitHub's IP addresses. For more information, see "[About GitHub's IP addresses](https://help.github.com/articles/about-github-s-ip-addresses/)."
+Returns meta information about GitHub, including a list of GitHub's IP addresses. For more information, see "[About GitHub's IP addresses](https://help.github.com/articles/about-github-s-ip-addresses/)."
+
+**Note:** The IP addresses shown in the documentation's response are only example values. You must always query the API directly to get the latest list of IP addresses.
 
 ```js
 octokit.meta.get();

docs/migrations/getImportStatus.md

@@ -25,7 +25,7 @@ An import that does not have errors will progress through these steps:
 If there are problems, you will see one of these in the `status` field:
 
 - `auth_failed` - the import requires authentication in order to connect to the original repository. To update authentication for the import, please see the [Update an import](https://docs.github.com/rest/reference/migrations#update-an-import) section.
-- `error` - the import encountered an error. The import progress response will include the `failed_step` and an error message. Contact [GitHub Support](https://github.com/contact) or [GitHub Premium Support](https://premium.githubsupport.com) for more information.
+- `error` - the import encountered an error. The import progress response will include the `failed_step` and an error message. Contact [GitHub Support](https://support.github.com/contact) or [GitHub Premium Support](https://premium.githubsupport.com) for more information.
 - `detection_needs_auth` - the importer requires authentication for the originating repository to continue detection. To update authentication for the import, please see the [Update an import](https://docs.github.com/rest/reference/migrations#update-an-import) section.
 - `detection_found_nothing` - the importer didn't recognize any source control at the URL. To resolve, [Cancel the import](https://docs.github.com/rest/reference/migrations#cancel-an-import) and [retry](https://docs.github.com/rest/reference/migrations#start-an-import) with the correct URL.
 - `detection_found_multiple` - the importer found several projects or repositories at the provided URL. When this is the case, the Import Progress response will also include a `project_choices` field with the possible project choices as values. To update project choice, please see the [Update an import](https://docs.github.com/rest/reference/migrations#update-an-import) section.

docs/repos/createFork.md

@@ -10,7 +10,7 @@ type: API method
 
 Create a fork for the authenticated user.
 
-**Note**: Forking a Repository happens asynchronously. You may have to wait a short period of time before you can access the git objects. If this takes longer than 5 minutes, be sure to contact [GitHub Support](https://github.com/contact) or [GitHub Premium Support](https://premium.githubsupport.com).
+**Note**: Forking a Repository happens asynchronously. You may have to wait a short period of time before you can access the git objects. If this takes longer than 5 minutes, be sure to contact [GitHub Support](https://support.github.com/contact) or [GitHub Premium Support](https://premium.githubsupport.com).
 
 ```js
 octokit.repos.createFork({

docs/repos/uploadReleaseAsset.md

@@ -25,7 +25,7 @@ When an upstream failure occurs, you will receive a `502 Bad Gateway` status. Th
 **Notes:**
 
 - GitHub renames asset filenames that have special characters, non-alphanumeric characters, and leading or trailing periods. The "[List assets for a release](https://docs.github.com/rest/reference/repos#list-assets-for-a-release)"
-  endpoint lists the renamed filenames. For more information and help, contact [GitHub Support](https://github.com/contact).
+  endpoint lists the renamed filenames. For more information and help, contact [GitHub Support](https://support.github.com/contact).
 - If you upload an asset with the same filename as another uploaded asset, you'll receive an error and must delete the old file before you can re-upload the new asset.
 
 ```js