fix: improve parameter descriptions for GET /repos/{owner}/{repo}/pulls/{pull_number}/requested_reviewers (#517)

Author: octokitbot

docs/pulls/listRequestedReviewers.md

@@ -8,6 +8,8 @@ type: API method
 
 # List requested reviewers for a pull request
 
+Lists the users or teams whose review is requested for a pull request. Once a requested reviewer submits a review, they are no longer considered a requested reviewer. Their review will instead be returned by the [List reviews for a pull request](https://docs.github.com/rest/pulls/reviews#list-reviews-for-a-pull-request) operation.
+
 ```js
 octokit.rest.pulls.listRequestedReviewers({
   owner,

scripts/update-endpoints/generated/endpoints.json

@@ -37993,7 +37993,7 @@
     "isDeprecated": false,
     "deprecationDate": null,
     "removalDate": null,
-    "description": "",
+    "description": "Lists the users or teams whose review is requested for a pull request. Once a requested reviewer submits a review, they are no longer considered a requested reviewer. Their review will instead be returned by the [List reviews for a pull request](https://docs.github.com/rest/pulls/reviews#list-reviews-for-a-pull-request) operation.",
     "documentationUrl": "https://docs.github.com/rest/reference/pulls#list-requested-reviewers-for-a-pull-request",
     "previews": [],
     "headers": [],

src/generated/method-types.ts

@@ -7174,7 +7174,9 @@ export type RestEndpointMethods = {
       defaults: RequestInterface["defaults"];
       endpoint: EndpointInterface<{ url: string }>;
     };
-
+    /**
+     * Lists the users or teams whose review is requested for a pull request. Once a requested reviewer submits a review, they are no longer considered a requested reviewer. Their review will instead be returned by the [List reviews for a pull request](https://docs.github.com/rest/pulls/reviews#list-reviews-for-a-pull-request) operation.
+     */
     listRequestedReviewers: {
       (
         params?: RestEndpointMethodTypes["pulls"]["listRequestedReviewers"]["parameters"]