fix wrong issue endpoints in swagger doc (#3914)

1 files changed, 192 insertions, 196 deletions

diff --git a/public/swagger.v1.json b/public/swagger.v1.json
index baacdfdf87..c5b1baa9ad 100644
--- a/public/swagger.v1.json
+++ b/public/swagger.v1.json
@@ -1605,7 +1605,7 @@
         }
       }
     },
-    "/repos/{owner}/{repo}/issue/{index}/comments": {
+    "/repos/{owner}/{repo}/issues": {
       "get": {
         "produces": [
           "application/json"
@@ -1613,8 +1613,8 @@
         "tags": [
           "issue"
         ],
-        "summary": "List all comments on an issue",
-        "operationId": "issueGetComments",
+        "summary": "List a repository's issues",
+        "operationId": "issueListIssues",
         "parameters": [
           {
             "type": "string",
@@ -1631,28 +1631,31 @@
             "required": true
           },
           {
+            "type": "string",
+            "description": "whether issue is open or closed",
+            "name": "state",
+            "in": "query"
+          },
+          {
             "type": "integer",
-            "description": "index of the issue",
-            "name": "id",
-            "in": "path",
-            "required": true
+            "description": "page number of requested issues",
+            "name": "page",
+            "in": "query"
           },
           {
             "type": "string",
-            "description": "if provided, only comments updated since the specified time are returned.",
-            "name": "string",
+            "description": "search string",
+            "name": "q",
             "in": "query"
           }
         ],
         "responses": {
           "200": {
-            "$ref": "#/responses/CommentList"
+            "$ref": "#/responses/IssueList"
           }
         }
-      }
-    },
-    "/repos/{owner}/{repo}/issue/{index}/labels": {
-      "put": {
+      },
+      "post": {
         "consumes": [
           "application/json"
         ],
@@ -1662,8 +1665,8 @@
         "tags": [
           "issue"
         ],
-        "summary": "Replace an issue's labels",
-        "operationId": "issueReplaceLabels",
+        "summary": "Create an issue",
+        "operationId": "issueCreateIssue",
         "parameters": [
           {
             "type": "string",
@@ -1680,38 +1683,30 @@
             "required": true
           },
           {
-            "type": "integer",
-            "description": "index of the issue",
-            "name": "index",
-            "in": "path",
-            "required": true
-          },
-          {
             "name": "body",
             "in": "body",
             "schema": {
-              "$ref": "#/definitions/IssueLabelsOption"
+              "$ref": "#/definitions/CreateIssueOption"
             }
           }
         ],
         "responses": {
-          "200": {
-            "$ref": "#/responses/LabelList"
+          "201": {
+            "$ref": "#/responses/Issue"
           }
         }
-      },
-      "post": {
-        "consumes": [
-          "application/json"
-        ],
+      }
+    },
+    "/repos/{owner}/{repo}/issues/comments": {
+      "get": {
         "produces": [
           "application/json"
         ],
         "tags": [
           "issue"
         ],
-        "summary": "Add a label to an issue",
-        "operationId": "issueAddLabel",
+        "summary": "List all comments in a repository",
+        "operationId": "issueGetRepoComments",
         "parameters": [
           {
             "type": "string",
@@ -1728,35 +1723,26 @@
             "required": true
           },
           {
-            "type": "integer",
-            "description": "index of the issue",
-            "name": "index",
-            "in": "path",
-            "required": true
-          },
-          {
-            "name": "body",
-            "in": "body",
-            "schema": {
-              "$ref": "#/definitions/IssueLabelsOption"
-            }
+            "type": "string",
+            "description": "if provided, only comments updated since the provided time are returned.",
+            "name": "string",
+            "in": "query"
           }
         ],
         "responses": {
           "200": {
-            "$ref": "#/responses/LabelList"
+            "$ref": "#/responses/CommentList"
           }
         }
-      },
+      }
+    },
+    "/repos/{owner}/{repo}/issues/comments/{id}": {
       "delete": {
-        "produces": [
-          "application/json"
-        ],
         "tags": [
           "issue"
         ],
-        "summary": "Remove all labels from an issue",
-        "operationId": "issueClearLabels",
+        "summary": "Delete a comment",
+        "operationId": "issueDeleteComment",
         "parameters": [
           {
             "type": "string",
@@ -1774,8 +1760,8 @@
           },
           {
             "type": "integer",
-            "description": "index of the issue",
-            "name": "index",
+            "description": "id of comment to delete",
+            "name": "id",
             "in": "path",
             "required": true
           }
@@ -1785,18 +1771,19 @@
             "$ref": "#/responses/empty"
           }
         }
-      }
-    },
-    "/repos/{owner}/{repo}/issue/{index}/labels/{id}": {
-      "delete": {
+      },
+      "patch": {
+        "consumes": [
+          "application/json"
+        ],
         "produces": [
           "application/json"
         ],
         "tags": [
           "issue"
         ],
-        "summary": "Remove a label from an issue",
-        "operationId": "issueRemoveLabel",
+        "summary": "Edit a comment",
+        "operationId": "issueEditComment",
         "parameters": [
           {
             "type": "string",
@@ -1814,27 +1801,27 @@
           },
           {
             "type": "integer",
-            "description": "index of the issue",
-            "name": "index",
+            "description": "id of the comment to edit",
+            "name": "id",
             "in": "path",
             "required": true
           },
           {
-            "type": "integer",
-            "description": "id of the label to remove",
-            "name": "id",
-            "in": "path",
-            "required": true
+            "name": "body",
+            "in": "body",
+            "schema": {
+              "$ref": "#/definitions/EditIssueCommentOption"
+            }
           }
         ],
         "responses": {
-          "204": {
-            "$ref": "#/responses/empty"
+          "200": {
+            "$ref": "#/responses/Comment"
           }
         }
       }
     },
-    "/repos/{owner}/{repo}/issues": {
+    "/repos/{owner}/{repo}/issues/{index}": {
       "get": {
         "produces": [
           "application/json"
@@ -1842,8 +1829,8 @@
         "tags": [
           "issue"
         ],
-        "summary": "List a repository's issues",
-        "operationId": "issueListIssues",
+        "summary": "Get an issue",
+        "operationId": "issueGetIssue",
         "parameters": [
           {
             "type": "string",
@@ -1860,31 +1847,20 @@
             "required": true
           },
           {
-            "type": "string",
-            "description": "whether issue is open or closed",
-            "name": "state",
-            "in": "query"
-          },
-          {
             "type": "integer",
-            "description": "page number of requested issues",
-            "name": "page",
-            "in": "query"
-          },
-          {
-            "type": "string",
-            "description": "search string",
-            "name": "q",
-            "in": "query"
+            "description": "index of the issue to get",
+            "name": "index",
+            "in": "path",
+            "required": true
           }
         ],
         "responses": {
           "200": {
-            "$ref": "#/responses/IssueList"
+            "$ref": "#/responses/Issue"
           }
         }
       },
-      "post": {
+      "patch": {
         "consumes": [
           "application/json"
         ],
@@ -1894,8 +1870,8 @@
         "tags": [
           "issue"
         ],
-        "summary": "Create an issue",
-        "operationId": "issueCreateIssue",
+        "summary": "Edit an issue",
+        "operationId": "issueEditIssue",
         "parameters": [
           {
             "type": "string",
@@ -1912,10 +1888,17 @@
             "required": true
           },
           {
+            "type": "integer",
+            "description": "index of the issue to edit",
+            "name": "index",
+            "in": "path",
+            "required": true
+          },
+          {
             "name": "body",
             "in": "body",
             "schema": {
-              "$ref": "#/definitions/CreateIssueOption"
+              "$ref": "#/definitions/EditIssueOption"
             }
           }
         ],
@@ -1926,7 +1909,7 @@
         }
       }
     },
-    "/repos/{owner}/{repo}/issues/comments": {
+    "/repos/{owner}/{repo}/issues/{index}/comments": {
       "get": {
         "produces": [
           "application/json"
@@ -1934,8 +1917,8 @@
         "tags": [
           "issue"
         ],
-        "summary": "List all comments in a repository",
-        "operationId": "issueGetRepoComments",
+        "summary": "List all comments on an issue",
+        "operationId": "issueGetComments",
         "parameters": [
           {
             "type": "string",
@@ -1952,8 +1935,15 @@
             "required": true
           },
           {
+            "type": "integer",
+            "description": "index of the issue",
+            "name": "id",
+            "in": "path",
+            "required": true
+          },
+          {
             "type": "string",
-            "description": "if provided, only comments updated since the provided time are returned.",
+            "description": "if provided, only comments updated since the specified time are returned.",
             "name": "string",
             "in": "query"
           }
@@ -1963,15 +1953,64 @@
             "$ref": "#/responses/CommentList"
           }
         }
+      },
+      "post": {
+        "consumes": [
+          "application/json"
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "tags": [
+          "issue"
+        ],
+        "summary": "Add a comment to an issue",
+        "operationId": "issueCreateComment",
+        "parameters": [
+          {
+            "type": "string",
+            "description": "owner of the repo",
+            "name": "owner",
+            "in": "path",
+            "required": true
+          },
+          {
+            "type": "string",
+            "description": "name of the repo",
+            "name": "repo",
+            "in": "path",
+            "required": true
+          },
+          {
+            "type": "integer",
+            "description": "index of the issue",
+            "name": "id",
+            "in": "path",
+            "required": true
+          },
+          {
+            "name": "body",
+            "in": "body",
+            "schema": {
+              "$ref": "#/definitions/CreateIssueOption"
+            }
+          }
+        ],
+        "responses": {
+          "201": {
+            "$ref": "#/responses/Comment"
+          }
+        }
       }
     },
-    "/repos/{owner}/{repo}/issues/comments/{id}": {
+    "/repos/{owner}/{repo}/issues/{index}/comments/{id}": {
       "delete": {
         "tags": [
           "issue"
         ],
         "summary": "Delete a comment",
-        "operationId": "issueDeleteComment",
+        "operationId": "issueDeleteCommentDeprecated",
+        "deprecated": true,
         "parameters": [
           {
             "type": "string",
@@ -1989,6 +2028,13 @@
           },
           {
             "type": "integer",
+            "description": "this parameter is ignored",
+            "name": "index",
+            "in": "path",
+            "required": true
+          },
+          {
+            "type": "integer",
             "description": "id of comment to delete",
             "name": "id",
             "in": "path",
@@ -2012,7 +2058,8 @@
           "issue"
         ],
         "summary": "Edit a comment",
-        "operationId": "issueEditComment",
+        "operationId": "issueEditCommentDeprecated",
+        "deprecated": true,
         "parameters": [
           {
             "type": "string",
@@ -2030,6 +2077,13 @@
           },
           {
             "type": "integer",
+            "description": "this parameter is ignored",
+            "name": "index",
+            "in": "path",
+            "required": true
+          },
+          {
+            "type": "integer",
             "description": "id of the comment to edit",
             "name": "id",
             "in": "path",
@@ -2050,7 +2104,7 @@
         }
       }
     },
-    "/repos/{owner}/{repo}/issues/{index}": {
+    "/repos/{owner}/{repo}/issues/{index}/labels": {
       "get": {
         "produces": [
           "application/json"
@@ -2058,8 +2112,8 @@
         "tags": [
           "issue"
         ],
-        "summary": "Get an issue",
-        "operationId": "issueGetIssue",
+        "summary": "Get an issue's labels",
+        "operationId": "issueGetLabels",
         "parameters": [
           {
             "type": "string",
@@ -2077,7 +2131,7 @@
           },
           {
             "type": "integer",
-            "description": "index of the issue to get",
+            "description": "index of the issue",
             "name": "index",
             "in": "path",
             "required": true
@@ -2085,11 +2139,14 @@
         ],
         "responses": {
           "200": {
-            "$ref": "#/responses/Issue"
+            "$ref": "#/responses/LabelList"
+          },
+          "404": {
+            "$ref": "#/responses/notFound"
           }
         }
       },
-      "patch": {
+      "put": {
         "consumes": [
           "application/json"
         ],
@@ -2099,8 +2156,8 @@
         "tags": [
           "issue"
         ],
-        "summary": "Edit an issue",
-        "operationId": "issueEditIssue",
+        "summary": "Replace an issue's labels",
+        "operationId": "issueReplaceLabels",
         "parameters": [
           {
             "type": "string",
@@ -2118,7 +2175,7 @@
           },
           {
             "type": "integer",
-            "description": "index of the issue to edit",
+            "description": "index of the issue",
             "name": "index",
             "in": "path",
             "required": true
@@ -2127,18 +2184,16 @@
             "name": "body",
             "in": "body",
             "schema": {
-              "$ref": "#/definitions/EditIssueOption"
+              "$ref": "#/definitions/IssueLabelsOption"
             }
           }
         ],
         "responses": {
-          "201": {
-            "$ref": "#/responses/Issue"
+          "200": {
+            "$ref": "#/responses/LabelList"
           }
         }
-      }
-    },
-    "/repos/{owner}/{repo}/issues/{index}/comments": {
+      },
       "post": {
         "consumes": [
           "application/json"
@@ -2149,8 +2204,8 @@
         "tags": [
           "issue"
         ],
-        "summary": "Add a comment to an issue",
-        "operationId": "issueCreateComment",
+        "summary": "Add a label to an issue",
+        "operationId": "issueAddLabel",
         "parameters": [
           {
             "type": "string",
@@ -2169,7 +2224,7 @@
           {
             "type": "integer",
             "description": "index of the issue",
-            "name": "id",
+            "name": "index",
             "in": "path",
             "required": true
           },
@@ -2177,25 +2232,25 @@
             "name": "body",
             "in": "body",
             "schema": {
-              "$ref": "#/definitions/CreateIssueOption"
+              "$ref": "#/definitions/IssueLabelsOption"
             }
           }
         ],
         "responses": {
-          "201": {
-            "$ref": "#/responses/Comment"
+          "200": {
+            "$ref": "#/responses/LabelList"
           }
         }
-      }
-    },
-    "/repos/{owner}/{repo}/issues/{index}/comments/{id}": {
+      },
       "delete": {
+        "produces": [
+          "application/json"
+        ],
         "tags": [
           "issue"
         ],
-        "summary": "Delete a comment",
-        "operationId": "issueDeleteCommentDeprecated",
-        "deprecated": true,
+        "summary": "Remove all labels from an issue",
+        "operationId": "issueClearLabels",
         "parameters": [
           {
             "type": "string",
@@ -2213,17 +2268,10 @@
           },
           {
             "type": "integer",
-            "description": "this parameter is ignored",
+            "description": "index of the issue",
             "name": "index",
             "in": "path",
             "required": true
-          },
-          {
-            "type": "integer",
-            "description": "id of comment to delete",
-            "name": "id",
-            "in": "path",
-            "required": true
           }
         ],
         "responses": {
@@ -2231,20 +2279,18 @@
             "$ref": "#/responses/empty"
           }
         }
-      },
-      "patch": {
-        "consumes": [
-          "application/json"
-        ],
+      }
+    },
+    "/repos/{owner}/{repo}/issues/{index}/labels/{id}": {
+      "delete": {
         "produces": [
           "application/json"
         ],
         "tags": [
           "issue"
         ],
-        "summary": "Edit a comment",
-        "operationId": "issueEditCommentDeprecated",
-        "deprecated": true,
+        "summary": "Remove a label from an issue",
+        "operationId": "issueRemoveLabel",
         "parameters": [
           {
             "type": "string",
@@ -2262,72 +2308,22 @@
           },
           {
             "type": "integer",
-            "description": "this parameter is ignored",
+            "description": "index of the issue",
             "name": "index",
             "in": "path",
             "required": true
           },
           {
             "type": "integer",
-            "description": "id of the comment to edit",
+            "description": "id of the label to remove",
             "name": "id",
             "in": "path",
             "required": true
-          },
-          {
-            "name": "body",
-            "in": "body",
-            "schema": {
-              "$ref": "#/definitions/EditIssueCommentOption"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "$ref": "#/responses/Comment"
-          }
-        }
-      }
-    },
-    "/repos/{owner}/{repo}/issues/{index}/labels": {
-      "get": {
-        "produces": [
-          "application/json"
-        ],
-        "tags": [
-          "issue"
-        ],
-        "summary": "Get an issue's labels",
-        "operationId": "issueGetLabels",
-        "parameters": [
-          {
-            "type": "string",
-            "description": "owner of the repo",
-            "name": "owner",
-            "in": "path",
-            "required": true
-          },
-          {
-            "type": "string",
-            "description": "name of the repo",
-            "name": "repo",
-            "in": "path",
-            "required": true
-          },
-          {
-            "type": "integer",
-            "description": "index of the issue",
-            "name": "index",
-            "in": "path",
-            "required": true
           }
         ],
         "responses": {
-          "200": {
-            "$ref": "#/responses/LabelList"
-          },
-          "404": {
-            "$ref": "#/responses/notFound"
+          "204": {
+            "$ref": "#/responses/empty"
           }
         }
       }