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/user_key.go

@@ -11,17 +11,13 @@ import (
 	"time"
 )
 
-// PublicKeyList represents a list of PublicKey
-// swagger:response PublicKeyList
-type PublicKeyList []*PublicKey
-
 // PublicKey publickey is a user key to push code to repository
-// swagger:response PublicKey
 type PublicKey struct {
 	ID      int64     `json:"id"`
 	Key     string    `json:"key"`
 	URL     string    `json:"url,omitempty"`
 	Title   string    `json:"title,omitempty"`
+	// swagger:strfmt date-time
 	Created time.Time `json:"created_at,omitempty"`
 }