Update OpenAPI Description (#54418)

Co-authored-by: Anne-Marie <[email protected]>

Author: docs-bot

Diff for: src/github-apps/lib/config.json

@@ -60,5 +60,5 @@
       "2022-11-28"
     ]
   },
-  "sha": "a06f88d7e84c4fde21c3d915cd510e858f0c8fe5"
+  "sha": "2320d61e4c805300787f8551fda53076bb4fae8b"
 }

Diff for: src/rest/data/fpt-2022-11-28/schema.json

@@ -237475,7 +237475,7 @@
                 "type": "object",
                 "properties": {
                   "seat_breakdown": {
-                    "title": "Copilot Business Seat Breakdown",
+                    "title": "Copilot Seat Breakdown",
                     "description": "The breakdown of Copilot Business seats for the organization.",
                     "type": "object",
                     "properties": {
@@ -237493,7 +237493,7 @@
                       },
                       "pending_invitation": {
                         "type": "integer",
-                        "description": "The number of seats that have been assigned to users that have not yet accepted an invitation to this organization."
+                        "description": "The number of users who have been invited to receive a Copilot seat through this organization."
                       },
                       "active_this_cycle": {
                         "type": "integer",
@@ -237507,17 +237507,16 @@
                   },
                   "public_code_suggestions": {
                     "type": "string",
-                    "description": "The organization policy for allowing or disallowing Copilot to make suggestions that match public code.",
+                    "description": "The organization policy for allowing or blocking suggestions matching public code (duplication detection filter).",
                     "enum": [
                       "allow",
                       "block",
-                      "unconfigured",
-                      "unknown"
+                      "unconfigured"
                     ]
                   },
                   "ide_chat": {
                     "type": "string",
-                    "description": "The organization policy for allowing or disallowing organization members to use Copilot Chat within their editor.",
+                    "description": "The organization policy for allowing or disallowing Copilot Chat in the IDE.",
                     "enum": [
                       "enabled",
                       "disabled",
@@ -237526,7 +237525,7 @@
                   },
                   "platform_chat": {
                     "type": "string",
-                    "description": "The organization policy for allowing or disallowing organization members to use Copilot features within github.com.",
+                    "description": "The organization policy for allowing or disallowing Copilot features on GitHub.com.",
                     "enum": [
                       "enabled",
                       "disabled",
@@ -237535,7 +237534,7 @@
                   },
                   "cli": {
                     "type": "string",
-                    "description": "The organization policy for allowing or disallowing organization members to use Copilot within their CLI.",
+                    "description": "The organization policy for allowing or disallowing Copilot in the CLI.",
                     "enum": [
                       "enabled",
                       "disabled",
@@ -237557,8 +237556,7 @@
                     "description": "The Copilot plan of the organization, or the parent enterprise, when applicable.",
                     "enum": [
                       "business",
-                      "enterprise",
-                      "unknown"
+                      "enterprise"
                     ]
                   }
                 },
@@ -344032,7 +344030,7 @@
             "type": "integer",
             "name": "sub_issue_id",
             "in": "body",
-            "description": "<p>The id of the sub-issue to add. The sub-issue must belong to the same repository as the parent issue</p>",
+            "description": "<p>The id of the sub-issue to add. The sub-issue must belong to the same repository owner as the parent issue</p>",
             "isRequired": true
           },
           {

Diff for: src/rest/data/ghec-2022-11-28/schema.json

@@ -251392,7 +251392,7 @@
                 "type": "object",
                 "properties": {
                   "seat_breakdown": {
-                    "title": "Copilot Business Seat Breakdown",
+                    "title": "Copilot Seat Breakdown",
                     "description": "The breakdown of Copilot Business seats for the organization.",
                     "type": "object",
                     "properties": {
@@ -251410,7 +251410,7 @@
                       },
                       "pending_invitation": {
                         "type": "integer",
-                        "description": "The number of seats that have been assigned to users that have not yet accepted an invitation to this organization."
+                        "description": "The number of users who have been invited to receive a Copilot seat through this organization."
                       },
                       "active_this_cycle": {
                         "type": "integer",
@@ -251424,17 +251424,16 @@
                   },
                   "public_code_suggestions": {
                     "type": "string",
-                    "description": "The organization policy for allowing or disallowing Copilot to make suggestions that match public code.",
+                    "description": "The organization policy for allowing or blocking suggestions matching public code (duplication detection filter).",
                     "enum": [
                       "allow",
                       "block",
-                      "unconfigured",
-                      "unknown"
+                      "unconfigured"
                     ]
                   },
                   "ide_chat": {
                     "type": "string",
-                    "description": "The organization policy for allowing or disallowing organization members to use Copilot Chat within their editor.",
+                    "description": "The organization policy for allowing or disallowing Copilot Chat in the IDE.",
                     "enum": [
                       "enabled",
                       "disabled",
@@ -251443,7 +251442,7 @@
                   },
                   "platform_chat": {
                     "type": "string",
-                    "description": "The organization policy for allowing or disallowing organization members to use Copilot features within github.com.",
+                    "description": "The organization policy for allowing or disallowing Copilot features on GitHub.com.",
                     "enum": [
                       "enabled",
                       "disabled",
@@ -251452,7 +251451,7 @@
                   },
                   "cli": {
                     "type": "string",
-                    "description": "The organization policy for allowing or disallowing organization members to use Copilot within their CLI.",
+                    "description": "The organization policy for allowing or disallowing Copilot in the CLI.",
                     "enum": [
                       "enabled",
                       "disabled",
@@ -251474,8 +251473,7 @@
                     "description": "The Copilot plan of the organization, or the parent enterprise, when applicable.",
                     "enum": [
                       "business",
-                      "enterprise",
-                      "unknown"
+                      "enterprise"
                     ]
                   }
                 },
@@ -376569,7 +376567,7 @@
             "type": "integer",
             "name": "sub_issue_id",
             "in": "body",
-            "description": "<p>The id of the sub-issue to add. The sub-issue must belong to the same repository as the parent issue</p>",
+            "description": "<p>The id of the sub-issue to add. The sub-issue must belong to the same repository owner as the parent issue</p>",
             "isRequired": true
           },
           {

Diff for: src/rest/lib/config.json

@@ -50,5 +50,5 @@
       ]
     }
   },
-  "sha": "a06f88d7e84c4fde21c3d915cd510e858f0c8fe5"
+  "sha": "2320d61e4c805300787f8551fda53076bb4fae8b"
 }

Diff for: src/webhooks/lib/config.json

@@ -1,3 +1,3 @@
 {
-  "sha": "a06f88d7e84c4fde21c3d915cd510e858f0c8fe5"
+  "sha": "2320d61e4c805300787f8551fda53076bb4fae8b"
 }