Merge pull request #20661 from github/repo-sync

repo sync

content/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md

@@ -31,6 +31,12 @@ If you want to use a hardware security key to authenticate to {% data variables.
 
 You can generate a new SSH key on your local machine. After you generate the key, you can add the key to your account on {% ifversion fpt or ghec or ghes %}{% data variables.product.product_location %}{% elsif ghae %}{% data variables.product.product_name %}{% endif %} to enable authentication for Git operations over SSH.
 
+{% ifversion ghes %}
+
+If you are a site administrator for {% data variables.product.product_location %}, you can use the same key to grant yourself administrative SSH access to the instance. For more information, see "[Accessing the administrative shell (SSH)](/admin/configuration/configuring-your-enterprise/accessing-the-administrative-shell-ssh)."
+
+{% endif %}
+
 {% data reusables.ssh.key-type-support %}
 
 {% data reusables.command_line.open_the_multi_os_terminal %}

data/graphql/ghae/schema.docs-ghae.graphql

@@ -7422,6 +7422,11 @@ type DeletePullRequestReviewCommentPayload {
   The pull request review the deleted comment belonged to.
   """
   pullRequestReview: PullRequestReview
+
+  """
+  The deleted pull request review comment.
+  """
+  pullRequestReviewComment: PullRequestReviewComment
 }
 
 """
@@ -9546,6 +9551,12 @@ type Enterprise implements Node {
     """
     first: Int
 
+    """
+    Only return members with this two-factor authentication status. Does not
+    include members who only have an account on a GitHub Enterprise Server instance.
+    """
+    hasTwoFactorEnabled: Boolean = null
+
     """
     Returns the last _n_ elements from the list.
     """
@@ -10323,6 +10334,11 @@ type EnterpriseOwnerInfo {
     """
     first: Int
 
+    """
+    Only return administrators with this two-factor authentication status.
+    """
+    hasTwoFactorEnabled: Boolean = null
+
     """
     Returns the last _n_ elements from the list.
     """

data/graphql/ghec/schema.docs.graphql

@@ -3621,6 +3621,50 @@ type ClearLabelsFromLabelablePayload {
   labelable: Labelable
 }
 
+"""
+Autogenerated input type of ClearProjectV2ItemFieldValue
+"""
+input ClearProjectV2ItemFieldValueInput {
+  """
+  A unique identifier for the client performing the mutation.
+  """
+  clientMutationId: String
+
+  """
+  The ID of the field to be cleared.
+  """
+  fieldId: ID!
+    @possibleTypes(
+      concreteTypes: ["ProjectV2Field", "ProjectV2IterationField", "ProjectV2SingleSelectField"]
+      abstractType: "ProjectV2FieldConfiguration"
+    )
+
+  """
+  The ID of the item to be cleared.
+  """
+  itemId: ID! @possibleTypes(concreteTypes: ["ProjectV2Item"])
+
+  """
+  The ID of the Project.
+  """
+  projectId: ID! @possibleTypes(concreteTypes: ["ProjectV2"])
+}
+
+"""
+Autogenerated return type of ClearProjectV2ItemFieldValue
+"""
+type ClearProjectV2ItemFieldValuePayload {
+  """
+  A unique identifier for the client performing the mutation.
+  """
+  clientMutationId: String
+
+  """
+  The updated item.
+  """
+  projectV2Item: ProjectV2Item
+}
+
 """
 Autogenerated input type of CloneProject
 """
@@ -8196,6 +8240,11 @@ type DeletePullRequestReviewCommentPayload {
   The pull request review the deleted comment belonged to.
   """
   pullRequestReview: PullRequestReview
+
+  """
+  The deleted pull request review comment.
+  """
+  pullRequestReviewComment: PullRequestReviewComment
 }
 
 """
@@ -10870,6 +10919,12 @@ type Enterprise implements Node {
     """
     first: Int
 
+    """
+    Only return members with this two-factor authentication status. Does not
+    include members who only have an account on a GitHub Enterprise Server instance.
+    """
+    hasTwoFactorEnabled: Boolean = null
+
     """
     Returns the last _n_ elements from the list.
     """
@@ -11647,6 +11702,11 @@ type EnterpriseOwnerInfo {
     """
     first: Int
 
+    """
+    Only return administrators with this two-factor authentication status.
+    """
+    hasTwoFactorEnabled: Boolean = null
+
     """
     Returns the last _n_ elements from the list.
     """
@@ -19558,6 +19618,18 @@ type Mutation {
     input: ClearLabelsFromLabelableInput!
   ): ClearLabelsFromLabelablePayload
 
+  """
+  This mutation clears the value of a field for an item in a Project. Currently
+  only text, number, date, assignees, labels, single-select, iteration and
+  milestone fields are supported.
+  """
+  clearProjectV2ItemFieldValue(
+    """
+    Parameters for ClearProjectV2ItemFieldValue
+    """
+    input: ClearProjectV2ItemFieldValueInput!
+  ): ClearProjectV2ItemFieldValuePayload
+
   """
   Creates a new project by cloning configuration from an existing project.
   """

data/graphql/schema.docs.graphql

@@ -3621,6 +3621,50 @@ type ClearLabelsFromLabelablePayload {
   labelable: Labelable
 }
 
+"""
+Autogenerated input type of ClearProjectV2ItemFieldValue
+"""
+input ClearProjectV2ItemFieldValueInput {
+  """
+  A unique identifier for the client performing the mutation.
+  """
+  clientMutationId: String
+
+  """
+  The ID of the field to be cleared.
+  """
+  fieldId: ID!
+    @possibleTypes(
+      concreteTypes: ["ProjectV2Field", "ProjectV2IterationField", "ProjectV2SingleSelectField"]
+      abstractType: "ProjectV2FieldConfiguration"
+    )
+
+  """
+  The ID of the item to be cleared.
+  """
+  itemId: ID! @possibleTypes(concreteTypes: ["ProjectV2Item"])
+
+  """
+  The ID of the Project.
+  """
+  projectId: ID! @possibleTypes(concreteTypes: ["ProjectV2"])
+}
+
+"""
+Autogenerated return type of ClearProjectV2ItemFieldValue
+"""
+type ClearProjectV2ItemFieldValuePayload {
+  """
+  A unique identifier for the client performing the mutation.
+  """
+  clientMutationId: String
+
+  """
+  The updated item.
+  """
+  projectV2Item: ProjectV2Item
+}
+
 """
 Autogenerated input type of CloneProject
 """
@@ -8196,6 +8240,11 @@ type DeletePullRequestReviewCommentPayload {
   The pull request review the deleted comment belonged to.
   """
   pullRequestReview: PullRequestReview
+
+  """
+  The deleted pull request review comment.
+  """
+  pullRequestReviewComment: PullRequestReviewComment
 }
 
 """
@@ -10870,6 +10919,12 @@ type Enterprise implements Node {
     """
     first: Int
 
+    """
+    Only return members with this two-factor authentication status. Does not
+    include members who only have an account on a GitHub Enterprise Server instance.
+    """
+    hasTwoFactorEnabled: Boolean = null
+
     """
     Returns the last _n_ elements from the list.
     """
@@ -11647,6 +11702,11 @@ type EnterpriseOwnerInfo {
     """
     first: Int
 
+    """
+    Only return administrators with this two-factor authentication status.
+    """
+    hasTwoFactorEnabled: Boolean = null
+
     """
     Returns the last _n_ elements from the list.
     """
@@ -19558,6 +19618,18 @@ type Mutation {
     input: ClearLabelsFromLabelableInput!
   ): ClearLabelsFromLabelablePayload
 
+  """
+  This mutation clears the value of a field for an item in a Project. Currently
+  only text, number, date, assignees, labels, single-select, iteration and
+  milestone fields are supported.
+  """
+  clearProjectV2ItemFieldValue(
+    """
+    Parameters for ClearProjectV2ItemFieldValue
+    """
+    input: ClearProjectV2ItemFieldValueInput!
+  ): ClearProjectV2ItemFieldValuePayload
+
   """
   Creates a new project by cloning configuration from an existing project.
   """

lib/graphql/static/changelog.json

@@ -1,4 +1,22 @@
 [
+  {
+    "schemaChanges": [
+      {
+        "title": "The GraphQL schema includes these changes:",
+        "changes": [
+          "<p>Type 'ClearProjectV2ItemFieldValueInput' was added</p>",
+          "<p>Type 'ClearProjectV2ItemFieldValuePayload' was added</p>",
+          "<p>Field <code>pullRequestReviewComment</code> was added to object type <code>DeletePullRequestReviewCommentPayload</code></p>",
+          "<p>Argument <code>hasTwoFactorEnabled: Boolean</code> added to field <code>Enterprise.members</code></p>",
+          "<p>Argument <code>hasTwoFactorEnabled: Boolean</code> added to field <code>EnterpriseOwnerInfo.admins</code></p>",
+          "<p>Field 'clearProjectV2ItemFieldValue<code>was added to object type</code>Mutation'</p>"
+        ]
+      }
+    ],
+    "previewChanges": [],
+    "upcomingChanges": [],
+    "date": "2022-09-16"
+  },
   {
     "schemaChanges": [
       {

lib/graphql/static/schema-dotcom.json

@@ -1924,6 +1924,40 @@
         }
       ]
     },
+    {
+      "name": "clearProjectV2ItemFieldValue",
+      "kind": "mutations",
+      "id": "clearprojectv2itemfieldvalue",
+      "href": "/graphql/reference/mutations#clearprojectv2itemfieldvalue",
+      "description": "<p>This mutation clears the value of a field for an item in a Project. Currently\nonly text, number, date, assignees, labels, single-select, iteration and\nmilestone fields are supported.</p>",
+      "inputFields": [
+        {
+          "name": "input",
+          "type": "ClearProjectV2ItemFieldValueInput!",
+          "id": "clearprojectv2itemfieldvalueinput",
+          "kind": "input-objects",
+          "href": "/graphql/reference/input-objects#clearprojectv2itemfieldvalueinput"
+        }
+      ],
+      "returnFields": [
+        {
+          "name": "clientMutationId",
+          "type": "String",
+          "id": "string",
+          "kind": "scalars",
+          "href": "/graphql/reference/scalars#string",
+          "description": "<p>A unique identifier for the client performing the mutation.</p>"
+        },
+        {
+          "name": "projectV2Item",
+          "type": "ProjectV2Item",
+          "id": "projectv2item",
+          "kind": "objects",
+          "href": "/graphql/reference/objects#projectv2item",
+          "description": "<p>The updated item.</p>"
+        }
+      ]
+    },
     {
       "name": "cloneProject",
       "kind": "mutations",
@@ -3575,6 +3609,14 @@
           "kind": "objects",
           "href": "/graphql/reference/objects#pullrequestreview",
           "description": "<p>The pull request review the deleted comment belonged to.</p>"
+        },
+        {
+          "name": "pullRequestReviewComment",
+          "type": "PullRequestReviewComment",
+          "id": "pullrequestreviewcomment",
+          "kind": "objects",
+          "href": "/graphql/reference/objects#pullrequestreviewcomment",
+          "description": "<p>The deleted pull request review comment.</p>"
         }
       ]
     },
@@ -18837,6 +18879,16 @@
                 "href": "/graphql/reference/scalars#int"
               }
             },
+            {
+              "name": "hasTwoFactorEnabled",
+              "description": "<p>Only return members with this two-factor authentication status. Does not\ninclude members who only have an account on a GitHub Enterprise Server instance.</p>",
+              "type": {
+                "name": "Boolean",
+                "id": "boolean",
+                "kind": "scalars",
+                "href": "/graphql/reference/scalars#boolean"
+              }
+            },
             {
               "name": "last",
               "description": "<p>Returns the last <em>n</em> elements from the list.</p>",
@@ -19783,6 +19835,16 @@
                 "href": "/graphql/reference/scalars#int"
               }
             },
+            {
+              "name": "hasTwoFactorEnabled",
+              "description": "<p>Only return administrators with this two-factor authentication status.</p>",
+              "type": {
+                "name": "Boolean",
+                "id": "boolean",
+                "kind": "scalars",
+                "href": "/graphql/reference/scalars#boolean"
+              }
+            },
             {
               "name": "last",
               "description": "<p>Returns the last <em>n</em> elements from the list.</p>",
@@ -81793,6 +81855,50 @@
         }
       ]
     },
+    {
+      "name": "ClearProjectV2ItemFieldValueInput",
+      "kind": "inputObjects",
+      "id": "clearprojectv2itemfieldvalueinput",
+      "href": "/graphql/reference/input-objects#clearprojectv2itemfieldvalueinput",
+      "description": "<p>Autogenerated input type of ClearProjectV2ItemFieldValue.</p>",
+      "inputFields": [
+        {
+          "name": "clientMutationId",
+          "description": "<p>A unique identifier for the client performing the mutation.</p>",
+          "type": "String",
+          "id": "string",
+          "kind": "scalars",
+          "href": "/graphql/reference/scalars#string"
+        },
+        {
+          "name": "fieldId",
+          "description": "<p>The ID of the field to be cleared.</p>",
+          "type": "ID!",
+          "id": "id",
+          "kind": "scalars",
+          "href": "/graphql/reference/scalars#id",
+          "isDeprecated": false
+        },
+        {
+          "name": "itemId",
+          "description": "<p>The ID of the item to be cleared.</p>",
+          "type": "ID!",
+          "id": "id",
+          "kind": "scalars",
+          "href": "/graphql/reference/scalars#id",
+          "isDeprecated": false
+        },
+        {
+          "name": "projectId",
+          "description": "<p>The ID of the Project.</p>",
+          "type": "ID!",
+          "id": "id",
+          "kind": "scalars",
+          "href": "/graphql/reference/scalars#id",
+          "isDeprecated": false
+        }
+      ]
+    },
     {
       "name": "CloneProjectInput",
       "kind": "inputObjects",

lib/graphql/static/schema-ghae.json

@@ -2676,6 +2676,14 @@
           "kind": "objects",
           "href": "/graphql/reference/objects#pullrequestreview",
           "description": "<p>The pull request review the deleted comment belonged to.</p>"
+        },
+        {
+          "name": "pullRequestReviewComment",
+          "type": "PullRequestReviewComment",
+          "id": "pullrequestreviewcomment",
+          "kind": "objects",
+          "href": "/graphql/reference/objects#pullrequestreviewcomment",
+          "description": "<p>The deleted pull request review comment.</p>"
         }
       ]
     },
@@ -16257,6 +16265,16 @@
                 "href": "/graphql/reference/scalars#int"
               }
             },
+            {
+              "name": "hasTwoFactorEnabled",
+              "description": "<p>Only return members with this two-factor authentication status. Does not\ninclude members who only have an account on a GitHub Enterprise Server instance.</p>",
+              "type": {
+                "name": "Boolean",
+                "id": "boolean",
+                "kind": "scalars",
+                "href": "/graphql/reference/scalars#boolean"
+              }
+            },
             {
               "name": "last",
               "description": "<p>Returns the last <em>n</em> elements from the list.</p>",
@@ -17203,6 +17221,16 @@
                 "href": "/graphql/reference/scalars#int"
               }
             },
+            {
+              "name": "hasTwoFactorEnabled",
+              "description": "<p>Only return administrators with this two-factor authentication status.</p>",
+              "type": {
+                "name": "Boolean",
+                "id": "boolean",
+                "kind": "scalars",
+                "href": "/graphql/reference/scalars#boolean"
+              }
+            },
             {
               "name": "last",
               "description": "<p>Returns the last <em>n</em> elements from the list.</p>",

lib/graphql/static/schema-ghec.json

@@ -1924,6 +1924,40 @@
         }
       ]
     },
+    {
+      "name": "clearProjectV2ItemFieldValue",
+      "kind": "mutations",
+      "id": "clearprojectv2itemfieldvalue",
+      "href": "/graphql/reference/mutations#clearprojectv2itemfieldvalue",
+      "description": "<p>This mutation clears the value of a field for an item in a Project. Currently\nonly text, number, date, assignees, labels, single-select, iteration and\nmilestone fields are supported.</p>",
+      "inputFields": [
+        {
+          "name": "input",
+          "type": "ClearProjectV2ItemFieldValueInput!",
+          "id": "clearprojectv2itemfieldvalueinput",
+          "kind": "input-objects",
+          "href": "/graphql/reference/input-objects#clearprojectv2itemfieldvalueinput"
+        }
+      ],
+      "returnFields": [
+        {
+          "name": "clientMutationId",
+          "type": "String",
+          "id": "string",
+          "kind": "scalars",
+          "href": "/graphql/reference/scalars#string",
+          "description": "<p>A unique identifier for the client performing the mutation.</p>"
+        },
+        {
+          "name": "projectV2Item",
+          "type": "ProjectV2Item",
+          "id": "projectv2item",
+          "kind": "objects",
+          "href": "/graphql/reference/objects#projectv2item",
+          "description": "<p>The updated item.</p>"
+        }
+      ]
+    },
     {
       "name": "cloneProject",
       "kind": "mutations",
@@ -3575,6 +3609,14 @@
           "kind": "objects",
           "href": "/graphql/reference/objects#pullrequestreview",
           "description": "<p>The pull request review the deleted comment belonged to.</p>"
+        },
+        {
+          "name": "pullRequestReviewComment",
+          "type": "PullRequestReviewComment",
+          "id": "pullrequestreviewcomment",
+          "kind": "objects",
+          "href": "/graphql/reference/objects#pullrequestreviewcomment",
+          "description": "<p>The deleted pull request review comment.</p>"
         }
       ]
     },
@@ -18837,6 +18879,16 @@
                 "href": "/graphql/reference/scalars#int"
               }
             },
+            {
+              "name": "hasTwoFactorEnabled",
+              "description": "<p>Only return members with this two-factor authentication status. Does not\ninclude members who only have an account on a GitHub Enterprise Server instance.</p>",
+              "type": {
+                "name": "Boolean",
+                "id": "boolean",
+                "kind": "scalars",
+                "href": "/graphql/reference/scalars#boolean"
+              }
+            },
             {
               "name": "last",
               "description": "<p>Returns the last <em>n</em> elements from the list.</p>",
@@ -19783,6 +19835,16 @@
                 "href": "/graphql/reference/scalars#int"
               }
             },
+            {
+              "name": "hasTwoFactorEnabled",
+              "description": "<p>Only return administrators with this two-factor authentication status.</p>",
+              "type": {
+                "name": "Boolean",
+                "id": "boolean",
+                "kind": "scalars",
+                "href": "/graphql/reference/scalars#boolean"
+              }
+            },
             {
               "name": "last",
               "description": "<p>Returns the last <em>n</em> elements from the list.</p>",
@@ -81793,6 +81855,50 @@
         }
       ]
     },
+    {
+      "name": "ClearProjectV2ItemFieldValueInput",
+      "kind": "inputObjects",
+      "id": "clearprojectv2itemfieldvalueinput",
+      "href": "/graphql/reference/input-objects#clearprojectv2itemfieldvalueinput",
+      "description": "<p>Autogenerated input type of ClearProjectV2ItemFieldValue.</p>",
+      "inputFields": [
+        {
+          "name": "clientMutationId",
+          "description": "<p>A unique identifier for the client performing the mutation.</p>",
+          "type": "String",
+          "id": "string",
+          "kind": "scalars",
+          "href": "/graphql/reference/scalars#string"
+        },
+        {
+          "name": "fieldId",
+          "description": "<p>The ID of the field to be cleared.</p>",
+          "type": "ID!",
+          "id": "id",
+          "kind": "scalars",
+          "href": "/graphql/reference/scalars#id",
+          "isDeprecated": false
+        },
+        {
+          "name": "itemId",
+          "description": "<p>The ID of the item to be cleared.</p>",
+          "type": "ID!",
+          "id": "id",
+          "kind": "scalars",
+          "href": "/graphql/reference/scalars#id",
+          "isDeprecated": false
+        },
+        {
+          "name": "projectId",
+          "description": "<p>The ID of the Project.</p>",
+          "type": "ID!",
+          "id": "id",
+          "kind": "scalars",
+          "href": "/graphql/reference/scalars#id",
+          "isDeprecated": false
+        }
+      ]
+    },
     {
       "name": "CloneProjectInput",
       "kind": "inputObjects",