[go] More idiomatic godoc comments (#10044)

* [go] More idiomatic godoc comments

* [go] Mark deprecated fields and functions

* [go] Minor mustache readability/consistency fixes

* [go] Mark deprecated operation parameters

* [go] Deprecate a petstore component property for testing

* [go] Apply deprecated godoc in Go servers also

samples/server/petstore/go-gin-api-server/api/openapi.yaml

@@ -76,7 +76,8 @@ paths:
       description: Multiple status values can be provided with comma separated strings
       operationId: findPetsByStatus
       parameters:
-      - description: Status values that need to be considered for filter
+      - deprecated: true
+        description: Status values that need to be considered for filter
         explode: false
         in: query
         name: status
@@ -759,6 +760,7 @@ components:
             name: tag
             wrapped: true
         status:
+          deprecated: true
           description: pet status in the store
           enum:
           - available

samples/server/petstore/go-gin-api-server/go/api_pet.go

@@ -31,6 +31,7 @@ func FindPetsByStatus(c *gin.Context) {
 }
 
 // FindPetsByTags - Finds Pets by tags
+// Deprecated
 func FindPetsByTags(c *gin.Context) {
 	c.JSON(http.StatusOK, gin.H{})
 }

samples/server/petstore/go-gin-api-server/go/model_pet.go

@@ -23,5 +23,6 @@ type Pet struct {
 	Tags []Tag `json:"tags,omitempty"`
 
 	// pet status in the store
+	// Deprecated
 	Status string `json:"status,omitempty"`
 }