feat: teams.getMembershipForUserInOrg, teams.addOrUpdateMembershipForUserInOrg, teams.removeMembershipForUserInOrg, teams.addOrUpdateProjectPermissionsInOrg, teams.checkPermissionsForProjectInOrg, teams.checkPermissionsForRepoInOrg, teams.addOrUpdateRepoPermissionsInOrg, issues.checkUserCanBeAssigned, migrations.getImportStatus, issues/list-milestones. Deprecation of previous method names

Co-authored-by: Octokit Bot <[email protected]>

Author: github-actions[bot]

docs/git/getRef.md

@@ -1,12 +1,12 @@
 ---
-name: Get a single reference
+name: Get a reference
 example: octokit.git.getRef({ owner, repo, ref })
 route: GET /repos/{owner}/{repo}/git/ref/{ref}
 scope: git
 type: API method
 ---
 
-# Get a single reference
+# Get a reference
 
 Returns a single reference from your Git database. The `:ref` in the URL must be formatted as `heads/<branch name>` for branches and `tags/<tag name>` for tags. If the `:ref` doesn't match an existing ref, a `404` is returned.
 
@@ -45,4 +45,4 @@ octokit.git.getRef({
   </tbody>
 </table>
 
-See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/git/refs/#get-a-single-reference).
+See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/git/refs/#get-a-reference).

docs/git/getTree.md

@@ -10,7 +10,7 @@ type: API method
 
 Returns a single tree using the SHA1 value for that tree.
 
-If `truncated` is `true` in the response then the number of items in the `tree` array exceeded our maximum limit. If you need to fetch more items, you can clone the repository and iterate over the Git data locally.
+If `truncated` is `true` in the response then the number of items in the `tree` array exceeded our maximum limit. If you need to fetch more items, use the non-recursive method of fetching trees, and fetch one sub-tree at a time.
 
 ```js
 octokit.git.getTree({
@@ -33,22 +33,16 @@ octokit.git.getTree({
   <tbody>
     <tr><td>owner</td><td>yes</td><td>
 
-owner parameter
-
 </td></tr>
 <tr><td>repo</td><td>yes</td><td>
 
-repo parameter
-
 </td></tr>
 <tr><td>tree_sha</td><td>yes</td><td>
 
-tree_sha parameter
-
 </td></tr>
 <tr><td>recursive</td><td>no</td><td>
 
-recursive parameter
+Setting this parameter to any value returns the objects or subtrees referenced by the tree specified in `:tree_sha`. For example, setting `recursive` to any of the following will enable returning objects or subtrees: `0`, `1`, `"true"`, and `"false"`. Omit this parameter to prevent recursively returning objects or subtrees.
 
 </td></tr>
   </tbody>

docs/issues/checkAssignee.md

@@ -1,12 +1,14 @@
 ---
-name: Check assignee
+name: Check if a user can be assigned
 example: octokit.issues.checkAssignee({ owner, repo, assignee })
 route: GET /repos/{owner}/{repo}/assignees/{assignee}
 scope: issues
 type: API method
 ---
 
-# Check assignee
+# Check if a user can be assigned
+
+**Deprecated:** This method has been renamed to issues.checkUserCanBeAssigned
 
 Checks if a user has permission to be assigned to an issue in this repository.
 
@@ -45,4 +47,4 @@ octokit.issues.checkAssignee({
   </tbody>
 </table>
 
-See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/issues/assignees/#check-assignee).
+See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/issues/assignees/#check-if-a-user-can-be-assigned).

docs/issues/checkUserCanBeAssigned.md

@@ -0,0 +1,48 @@
+---
+name: Check if a user can be assigned
+example: octokit.issues.checkUserCanBeAssigned({ owner, repo, assignee })
+route: GET /repos/{owner}/{repo}/assignees/{assignee}
+scope: issues
+type: API method
+---
+
+# Check if a user can be assigned
+
+Checks if a user has permission to be assigned to an issue in this repository.
+
+If the `assignee` can be assigned to issues in the repository, a `204` header with no content is returned.
+
+Otherwise a `404` status code is returned.
+
+```js
+octokit.issues.checkUserCanBeAssigned({
+  owner,
+  repo,
+  assignee,
+});
+```
+
+## Parameters
+
+<table>
+  <thead>
+    <tr>
+      <th>name</th>
+      <th>required</th>
+      <th>description</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr><td>owner</td><td>yes</td><td>
+
+</td></tr>
+<tr><td>repo</td><td>yes</td><td>
+
+</td></tr>
+<tr><td>assignee</td><td>yes</td><td>
+
+</td></tr>
+  </tbody>
+</table>
+
+See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/issues/assignees/#check-if-a-user-can-be-assigned).

docs/issues/createComment.md

@@ -1,12 +1,12 @@
 ---
-name: Create a comment
+name: Create an issue comment
 example: octokit.issues.createComment({ owner, repo, issue_number, body })
 route: POST /repos/{owner}/{repo}/issues/{issue_number}/comments
 scope: issues
 type: API method
 ---
 
-# Create a comment
+# Create an issue comment
 
 This endpoint triggers [notifications](https://help.github.com/articles/about-notifications/). Creating content too quickly using this endpoint may result in abuse rate limiting. See "[Abuse rate limits](https://developer.github.com/v3/#abuse-rate-limits)" and "[Dealing with abuse rate limits](https://developer.github.com/v3/guides/best-practices-for-integrators/#dealing-with-abuse-rate-limits)" for details.
 
@@ -47,4 +47,4 @@ The contents of the comment.
   </tbody>
 </table>
 
-See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/issues/comments/#create-a-comment).
+See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/issues/comments/#create-an-issue-comment).

docs/issues/deleteComment.md

@@ -1,12 +1,12 @@
 ---
-name: Delete a comment
+name: Delete an issue comment
 example: octokit.issues.deleteComment({ owner, repo, comment_id })
 route: DELETE /repos/{owner}/{repo}/issues/comments/{comment_id}
 scope: issues
 type: API method
 ---
 
-# Delete a comment
+# Delete an issue comment
 
 ```js
 octokit.issues.deleteComment({
@@ -39,4 +39,4 @@ octokit.issues.deleteComment({
   </tbody>
 </table>
 
-See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/issues/comments/#delete-a-comment).
+See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/issues/comments/#delete-an-issue-comment).

docs/issues/getComment.md

@@ -1,12 +1,12 @@
 ---
-name: Get a single comment
+name: Get an issue comment
 example: octokit.issues.getComment({ owner, repo, comment_id })
 route: GET /repos/{owner}/{repo}/issues/comments/{comment_id}
 scope: issues
 type: API method
 ---
 
-# Get a single comment
+# Get an issue comment
 
 ```js
 octokit.issues.getComment({
@@ -39,4 +39,4 @@ octokit.issues.getComment({
   </tbody>
 </table>
 
-See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/issues/comments/#get-a-single-comment).
+See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/issues/comments/#get-an-issue-comment).

docs/issues/getEvent.md

@@ -1,12 +1,12 @@
 ---
-name: Get a single event
+name: Get an issue event
 example: octokit.issues.getEvent({ owner, repo, event_id })
 route: GET /repos/{owner}/{repo}/issues/events/{event_id}
 scope: issues
 type: API method
 ---
 
-# Get a single event
+# Get an issue event
 
 ```js
 octokit.issues.getEvent({
@@ -39,4 +39,4 @@ octokit.issues.getEvent({
   </tbody>
 </table>
 
-See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/issues/events/#get-a-single-event).
+See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/issues/events/#get-an-issue-event).

docs/issues/getLabel.md

@@ -1,12 +1,12 @@
 ---
-name: Get a single label
+name: Get a label
 example: octokit.issues.getLabel({ owner, repo, name })
 route: GET /repos/{owner}/{repo}/labels/{name}
 scope: issues
 type: API method
 ---
 
-# Get a single label
+# Get a label
 
 ```js
 octokit.issues.getLabel({
@@ -39,4 +39,4 @@ octokit.issues.getLabel({
   </tbody>
 </table>
 
-See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/issues/labels/#get-a-single-label).
+See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/issues/labels/#get-a-label).

docs/issues/getMilestone.md

@@ -1,12 +1,12 @@
 ---
-name: Get a single milestone
+name: Get a milestone
 example: octokit.issues.getMilestone({ owner, repo, milestone_number })
 route: GET /repos/{owner}/{repo}/milestones/{milestone_number}
 scope: issues
 type: API method
 ---
 
-# Get a single milestone
+# Get a milestone
 
 ```js
 octokit.issues.getMilestone({
@@ -39,4 +39,4 @@ octokit.issues.getMilestone({
   </tbody>
 </table>
 
-See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/issues/milestones/#get-a-single-milestone).
+See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/issues/milestones/#get-a-milestone).