Add decorated OpenAPI schema files

lib/rest/static/decorated/api.github.com.json

@@ -189704,7 +189704,7 @@
           },
           {
             "httpStatusCode": "204",
-            "description": "<p>Response when person is already a collaborator</p>"
+            "description": "<p>Response when:</p>\n<ul>\n<li>an existing collaborator is added as a collaborator</li>\n<li>an organization member is added as an individual collaborator</li>\n<li>an existing team member (whose team is also a repository collaborator) is added as an individual collaborator</li>\n</ul>"
           },
           {
             "httpStatusCode": "403",
@@ -231469,8 +231469,17 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Creating a gist",
-              "acceptHeader": "application/vnd.github.v3+json"
+              "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "description": "Example of a gist",
+                "public": false,
+                "files": {
+                  "README.md": {
+                    "content": "Hello World"
+                  }
+                }
+              }
             },
             "response": {
               "statusCode": "201",
@@ -235226,8 +235235,16 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Updating a gist",
               "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "description": "An update to a gist",
+                "files": {
+                  "README.md": {
+                    "content": "Hello World from GitHub"
+                  }
+                }
+              },
               "parameters": {
                 "gist_id": "GIST_ID"
               }
@@ -241081,8 +241098,11 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Creating a comment in a gist",
               "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "body": "This is a comment to a gist"
+              },
               "parameters": {
                 "gist_id": "GIST_ID"
               }
@@ -241778,8 +241798,11 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Updating a comment in a gist",
               "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "body": "This is an update to a comment in a gist"
+              },
               "parameters": {
                 "gist_id": "GIST_ID",
                 "comment_id": "COMMENT_ID"
@@ -489644,6 +489667,19 @@
                       "format": "date-time",
                       "readOnly": true
                     },
+                    "updated_at": {
+                      "anyOf": [
+                        {
+                          "type": "null"
+                        },
+                        {
+                          "type": "string",
+                          "description": "The time that the alert was last updated in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.",
+                          "format": "date-time",
+                          "readOnly": true
+                        }
+                      ]
+                    },
                     "url": {
                       "type": "string",
                       "description": "The REST API URL of the alert resource.",
@@ -492601,6 +492637,19 @@
                       "format": "date-time",
                       "readOnly": true
                     },
+                    "updated_at": {
+                      "anyOf": [
+                        {
+                          "type": "null"
+                        },
+                        {
+                          "type": "string",
+                          "description": "The time that the alert was last updated in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.",
+                          "format": "date-time",
+                          "readOnly": true
+                        }
+                      ]
+                    },
                     "url": {
                       "type": "string",
                       "description": "The REST API URL of the alert resource.",

lib/rest/static/decorated/ghes-3.1.json

@@ -124852,7 +124852,7 @@
           },
           {
             "httpStatusCode": "204",
-            "description": "<p>Response when person is already a collaborator</p>"
+            "description": "<p>Response when:</p>\n<ul>\n<li>an existing collaborator is added as a collaborator</li>\n<li>an organization member is added as an individual collaborator</li>\n<li>an existing team member (whose team is also a repository collaborator) is added as an individual collaborator</li>\n</ul>"
           },
           {
             "httpStatusCode": "403",
@@ -166543,8 +166543,17 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Creating a gist",
-              "acceptHeader": "application/vnd.github.v3+json"
+              "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "description": "Example of a gist",
+                "public": false,
+                "files": {
+                  "README.md": {
+                    "content": "Hello World"
+                  }
+                }
+              }
             },
             "response": {
               "statusCode": "201",
@@ -170300,8 +170309,16 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Updating a gist",
               "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "description": "An update to a gist",
+                "files": {
+                  "README.md": {
+                    "content": "Hello World from GitHub"
+                  }
+                }
+              },
               "parameters": {
                 "gist_id": "GIST_ID"
               }
@@ -176155,8 +176172,11 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Creating a comment in a gist",
               "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "body": "This is a comment to a gist"
+              },
               "parameters": {
                 "gist_id": "GIST_ID"
               }
@@ -176852,8 +176872,11 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Updating a comment in a gist",
               "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "body": "This is an update to a comment in a gist"
+              },
               "parameters": {
                 "gist_id": "GIST_ID",
                 "comment_id": "COMMENT_ID"

lib/rest/static/decorated/ghes-3.2.json

@@ -128102,7 +128102,7 @@
           },
           {
             "httpStatusCode": "204",
-            "description": "<p>Response when person is already a collaborator</p>"
+            "description": "<p>Response when:</p>\n<ul>\n<li>an existing collaborator is added as a collaborator</li>\n<li>an organization member is added as an individual collaborator</li>\n<li>an existing team member (whose team is also a repository collaborator) is added as an individual collaborator</li>\n</ul>"
           },
           {
             "httpStatusCode": "403",
@@ -172286,8 +172286,17 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Creating a gist",
-              "acceptHeader": "application/vnd.github.v3+json"
+              "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "description": "Example of a gist",
+                "public": false,
+                "files": {
+                  "README.md": {
+                    "content": "Hello World"
+                  }
+                }
+              }
             },
             "response": {
               "statusCode": "201",
@@ -176043,8 +176052,16 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Updating a gist",
               "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "description": "An update to a gist",
+                "files": {
+                  "README.md": {
+                    "content": "Hello World from GitHub"
+                  }
+                }
+              },
               "parameters": {
                 "gist_id": "GIST_ID"
               }
@@ -181898,8 +181915,11 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Creating a comment in a gist",
               "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "body": "This is a comment to a gist"
+              },
               "parameters": {
                 "gist_id": "GIST_ID"
               }
@@ -182595,8 +182615,11 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Updating a comment in a gist",
               "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "body": "This is an update to a comment in a gist"
+              },
               "parameters": {
                 "gist_id": "GIST_ID",
                 "comment_id": "COMMENT_ID"

lib/rest/static/decorated/ghes-3.3.json

@@ -128395,7 +128395,7 @@
           },
           {
             "httpStatusCode": "204",
-            "description": "<p>Response when person is already a collaborator</p>"
+            "description": "<p>Response when:</p>\n<ul>\n<li>an existing collaborator is added as a collaborator</li>\n<li>an organization member is added as an individual collaborator</li>\n<li>an existing team member (whose team is also a repository collaborator) is added as an individual collaborator</li>\n</ul>"
           },
           {
             "httpStatusCode": "403",
@@ -172868,8 +172868,17 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Creating a gist",
-              "acceptHeader": "application/vnd.github.v3+json"
+              "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "description": "Example of a gist",
+                "public": false,
+                "files": {
+                  "README.md": {
+                    "content": "Hello World"
+                  }
+                }
+              }
             },
             "response": {
               "statusCode": "201",
@@ -176625,8 +176634,16 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Updating a gist",
               "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "description": "An update to a gist",
+                "files": {
+                  "README.md": {
+                    "content": "Hello World from GitHub"
+                  }
+                }
+              },
               "parameters": {
                 "gist_id": "GIST_ID"
               }
@@ -182480,8 +182497,11 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Creating a comment in a gist",
               "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "body": "This is a comment to a gist"
+              },
               "parameters": {
                 "gist_id": "GIST_ID"
               }
@@ -183177,8 +183197,11 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Updating a comment in a gist",
               "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "body": "This is an update to a comment in a gist"
+              },
               "parameters": {
                 "gist_id": "GIST_ID",
                 "comment_id": "COMMENT_ID"

lib/rest/static/decorated/ghes-3.4.json

@@ -132655,7 +132655,7 @@
           },
           {
             "httpStatusCode": "204",
-            "description": "<p>Response when person is already a collaborator</p>"
+            "description": "<p>Response when:</p>\n<ul>\n<li>an existing collaborator is added as a collaborator</li>\n<li>an organization member is added as an individual collaborator</li>\n<li>an existing team member (whose team is also a repository collaborator) is added as an individual collaborator</li>\n</ul>"
           },
           {
             "httpStatusCode": "403",
@@ -180784,8 +180784,17 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Creating a gist",
-              "acceptHeader": "application/vnd.github.v3+json"
+              "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "description": "Example of a gist",
+                "public": false,
+                "files": {
+                  "README.md": {
+                    "content": "Hello World"
+                  }
+                }
+              }
             },
             "response": {
               "statusCode": "201",
@@ -184541,8 +184550,16 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Updating a gist",
               "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "description": "An update to a gist",
+                "files": {
+                  "README.md": {
+                    "content": "Hello World from GitHub"
+                  }
+                }
+              },
               "parameters": {
                 "gist_id": "GIST_ID"
               }
@@ -190396,8 +190413,11 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Creating a comment in a gist",
               "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "body": "This is a comment to a gist"
+              },
               "parameters": {
                 "gist_id": "GIST_ID"
               }
@@ -191093,8 +191113,11 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Updating a comment in a gist",
               "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "body": "This is an update to a comment in a gist"
+              },
               "parameters": {
                 "gist_id": "GIST_ID",
                 "comment_id": "COMMENT_ID"

lib/rest/static/decorated/ghes-3.5.json

@@ -144450,7 +144450,7 @@
           },
           {
             "httpStatusCode": "204",
-            "description": "<p>Response when person is already a collaborator</p>"
+            "description": "<p>Response when:</p>\n<ul>\n<li>an existing collaborator is added as a collaborator</li>\n<li>an organization member is added as an individual collaborator</li>\n<li>an existing team member (whose team is also a repository collaborator) is added as an individual collaborator</li>\n</ul>"
           },
           {
             "httpStatusCode": "403",
@@ -192623,8 +192623,17 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Creating a gist",
-              "acceptHeader": "application/vnd.github.v3+json"
+              "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "description": "Example of a gist",
+                "public": false,
+                "files": {
+                  "README.md": {
+                    "content": "Hello World"
+                  }
+                }
+              }
             },
             "response": {
               "statusCode": "201",
@@ -196380,8 +196389,16 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Updating a gist",
               "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "description": "An update to a gist",
+                "files": {
+                  "README.md": {
+                    "content": "Hello World from GitHub"
+                  }
+                }
+              },
               "parameters": {
                 "gist_id": "GIST_ID"
               }
@@ -202235,8 +202252,11 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Creating a comment in a gist",
               "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "body": "This is a comment to a gist"
+              },
               "parameters": {
                 "gist_id": "GIST_ID"
               }
@@ -202932,8 +202952,11 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Updating a comment in a gist",
               "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "body": "This is an update to a comment in a gist"
+              },
               "parameters": {
                 "gist_id": "GIST_ID",
                 "comment_id": "COMMENT_ID"

lib/rest/static/decorated/github.ae.json

@@ -128023,7 +128023,7 @@
           },
           {
             "httpStatusCode": "204",
-            "description": "<p>Response when person is already a collaborator</p>"
+            "description": "<p>Response when:</p>\n<ul>\n<li>an existing collaborator is added as a collaborator</li>\n<li>an organization member is added as an individual collaborator</li>\n<li>an existing team member (whose team is also a repository collaborator) is added as an individual collaborator</li>\n</ul>"
           },
           {
             "httpStatusCode": "403",
@@ -169522,8 +169522,17 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Creating a gist",
-              "acceptHeader": "application/vnd.github.v3+json"
+              "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "description": "Example of a gist",
+                "public": false,
+                "files": {
+                  "README.md": {
+                    "content": "Hello World"
+                  }
+                }
+              }
             },
             "response": {
               "statusCode": "201",
@@ -173279,8 +173288,16 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Updating a gist",
               "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "description": "An update to a gist",
+                "files": {
+                  "README.md": {
+                    "content": "Hello World from GitHub"
+                  }
+                }
+              },
               "parameters": {
                 "gist_id": "GIST_ID"
               }
@@ -179134,8 +179151,11 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Creating a comment in a gist",
               "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "body": "This is a comment to a gist"
+              },
               "parameters": {
                 "gist_id": "GIST_ID"
               }
@@ -179831,8 +179851,11 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Updating a comment in a gist",
               "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "body": "This is an update to a comment in a gist"
+              },
               "parameters": {
                 "gist_id": "GIST_ID",
                 "comment_id": "COMMENT_ID"