fix(typescript): update documentation on endpoints (#639)

WIP octokit/openapi updated

Author: octokitbot

docs/pulls/checkIfMerged.md

@@ -8,6 +8,8 @@ type: API method
 
 # Check if a pull request has been merged
 
+Checks if a pull request has been merged into the base branch. The HTTP status of the response indicates whether or not the pull request has been merged; the response body is empty.
+
 ```js
 octokit.rest.pulls.checkIfMerged({
   owner,

docs/pulls/deletePendingReview.md

@@ -8,6 +8,8 @@ type: API method
 
 # Delete a pending review for a pull request
 
+Deletes a pull request review that has not been submitted. Submitted reviews cannot be deleted.
+
 ```js
 octokit.rest.pulls.deletePendingReview({
   owner,

docs/pulls/getReview.md

@@ -8,6 +8,8 @@ type: API method
 
 # Get a review for a pull request
 
+Retrieves a pull request review by its ID.
+
 ```js
 octokit.rest.pulls.getReview({
   owner,

docs/pulls/merge.md

@@ -8,6 +8,7 @@ type: API method
 
 # Merge a pull request
 
+Merges a pull request into the base branch.
 This endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. See "[Secondary rate limits](https://docs.github.com/rest/overview/resources-in-the-rest-api#secondary-rate-limits)" and "[Dealing with secondary rate limits](https://docs.github.com/rest/guides/best-practices-for-integrators#dealing-with-secondary-rate-limits)" for details.
 
 ```js

docs/pulls/removeRequestedReviewers.md

@@ -8,6 +8,8 @@ type: API method
 
 # Remove requested reviewers from a pull request
 
+Removes review requests from a pull request for a given set of users and/or teams.
+
 ```js
 octokit.rest.pulls.removeRequestedReviewers({
   owner,

docs/repos/getLatestPagesBuild.md

@@ -8,6 +8,10 @@ type: API method
 
 # Get latest Pages build
 
+Gets information about the single most recent build of a GitHub Pages site.
+
+A token with the `repo` scope is required. GitHub Apps must have the `pages:read` permission.
+
 ```js
 octokit.rest.repos.getLatestPagesBuild({
   owner,

docs/repos/getPages.md

@@ -8,6 +8,10 @@ type: API method
 
 # Get a GitHub Pages site
 
+Gets information about a GitHub Pages site.
+
+A token with the `repo` scope is required. GitHub Apps must have the `pages:read` permission.
+
 ```js
 octokit.rest.repos.getPages({
   owner,

docs/repos/getPagesBuild.md

@@ -8,6 +8,10 @@ type: API method
 
 # Get GitHub Pages build
 
+Gets information about a GitHub Pages build.
+
+A token with the `repo` scope is required. GitHub Apps must have the `pages:read` permission.
+
 ```js
 octokit.rest.repos.getPagesBuild({
   owner,

docs/repos/listPagesBuilds.md

@@ -8,6 +8,10 @@ type: API method
 
 # List GitHub Pages builds
 
+Lists builts of a GitHub Pages site.
+
+A token with the `repo` scope is required. GitHub Apps must have the `pages:read` permission.
+
 ```js
 octokit.rest.repos.listPagesBuilds({
   owner,