Update swagger documentation (#2899)

* Update swagger documentation

Add docs for missing endpoints
Add documentation for request parameters
Make parameter naming consistent
Fix response documentation

* Restore delete comments

vendor/code.gitea.io/sdk/gitea/issue_label.go

@@ -11,14 +11,16 @@ import (
 )
 
 // Label a label to an issue or a pr
+// swagger:model
 type Label struct {
 	ID    int64  `json:"id"`
 	Name  string `json:"name"`
+	// example: 00aabb
 	Color string `json:"color"`
 	URL   string `json:"url"`
 }
 
-// ListRepoLabels list lables of one reppsitory
+// ListRepoLabels list labels of one repository
 func (c *Client) ListRepoLabels(owner, repo string) ([]*Label, error) {
 	labels := make([]*Label, 0, 10)
 	return labels, c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/labels", owner, repo), nil, nil, &labels)
@@ -31,9 +33,12 @@ func (c *Client) GetRepoLabel(owner, repo string, id int64) (*Label, error) {
 	return label, c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/labels/%d", owner, repo, id), nil, nil, label)
 }
 
-// CreateLabelOption create options when one label of repository
+// CreateLabelOption options for creating a label
 type CreateLabelOption struct {
+	// required:true
 	Name  string `json:"name" binding:"Required"`
+	// required:true
+	// example: #00aabb
 	Color string `json:"color" binding:"Required;Size(7)"`
 }
 
@@ -48,7 +53,7 @@ func (c *Client) CreateLabel(owner, repo string, opt CreateLabelOption) (*Label,
 		jsonHeader, bytes.NewReader(body), label)
 }
 
-// EditLabelOption edit label options
+// EditLabelOption options for editing a label
 type EditLabelOption struct {
 	Name  *string `json:"name"`
 	Color *string `json:"color"`
@@ -71,8 +76,9 @@ func (c *Client) DeleteLabel(owner, repo string, id int64) error {
 	return err
 }
 
-// IssueLabelsOption list one issue's labels options
+// IssueLabelsOption a collection of labels
 type IssueLabelsOption struct {
+	// list of label IDs
 	Labels []int64 `json:"labels"`
 }