[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

modules/openapi-generator/src/main/java/org/openapitools/codegen/CodegenParameter.java

@@ -51,6 +51,7 @@ public class CodegenParameter implements IJsonSchemaValidationProperties {
     public Map<String, Object> vendorExtensions = new HashMap<String, Object>();
     public boolean hasValidation;
     public boolean isNullable;
+    public boolean isDeprecated;
     /**
      * Determines whether this parameter is mandatory. If the parameter is in "path",
      * this property is required and its value MUST be true. Otherwise, the property
@@ -179,6 +180,7 @@ public class CodegenParameter implements IJsonSchemaValidationProperties {
         }
         output.hasValidation = this.hasValidation;
         output.isNullable = this.isNullable;
+        output.isDeprecated = this.isDeprecated;
         output.isBinary = this.isBinary;
         output.isByteArray = this.isByteArray;
         output.isString = this.isString;
@@ -211,7 +213,7 @@ public class CodegenParameter implements IJsonSchemaValidationProperties {
 
     @Override
     public int hashCode() {
-        return Objects.hash(isFormParam, isQueryParam, isPathParam, isHeaderParam, isCookieParam, isBodyParam, isContainer, isCollectionFormatMulti, isPrimitiveType, isModel, isExplode, baseName, paramName, dataType, datatypeWithEnum, dataFormat, collectionFormat, description, unescapedDescription, baseType, defaultValue, enumName, style, isDeepObject, example, jsonSchema, isString, isNumeric, isInteger, isLong, isNumber, isFloat, isDouble, isDecimal, isByteArray, isBinary, isBoolean, isDate, isDateTime, isUuid, isUri, isEmail, isFreeFormObject, isAnyType, isArray, isMap, isFile, isEnum, _enum, allowableValues, items, mostInnerItems, additionalProperties, vars, requiredVars, vendorExtensions, hasValidation, getMaxProperties(), getMinProperties(), isNullable, required, getMaximum(), getExclusiveMaximum(), getMinimum(), getExclusiveMinimum(), getMaxLength(), getMinLength(), getPattern(), getMaxItems(), getMinItems(), getUniqueItems(), contentType, multipleOf, isNull, additionalPropertiesIsAnyType, hasVars, hasRequired, isShort, isUnboundedInteger);
+        return Objects.hash(isFormParam, isQueryParam, isPathParam, isHeaderParam, isCookieParam, isBodyParam, isContainer, isCollectionFormatMulti, isPrimitiveType, isModel, isExplode, baseName, paramName, dataType, datatypeWithEnum, dataFormat, collectionFormat, description, unescapedDescription, baseType, defaultValue, enumName, style, isDeepObject, example, jsonSchema, isString, isNumeric, isInteger, isLong, isNumber, isFloat, isDouble, isDecimal, isByteArray, isBinary, isBoolean, isDate, isDateTime, isUuid, isUri, isEmail, isFreeFormObject, isAnyType, isArray, isMap, isFile, isEnum, _enum, allowableValues, items, mostInnerItems, additionalProperties, vars, requiredVars, vendorExtensions, hasValidation, getMaxProperties(), getMinProperties(), isNullable, isDeprecated, required, getMaximum(), getExclusiveMaximum(), getMinimum(), getExclusiveMinimum(), getMaxLength(), getMinLength(), getPattern(), getMaxItems(), getMinItems(), getUniqueItems(), contentType, multipleOf, isNull, additionalPropertiesIsAnyType, hasVars, hasRequired, isShort, isUnboundedInteger);
     }
 
     @Override
@@ -256,6 +258,7 @@ public class CodegenParameter implements IJsonSchemaValidationProperties {
                 isEnum == that.isEnum &&
                 hasValidation == that.hasValidation &&
                 isNullable == that.isNullable &&
+                isDeprecated == that.isDeprecated &&
                 required == that.required &&
                 isNull == that.isNull &&
                 getAdditionalPropertiesIsAnyType() == that.getAdditionalPropertiesIsAnyType() &&
@@ -365,6 +368,7 @@ public class CodegenParameter implements IJsonSchemaValidationProperties {
         sb.append(", maxProperties=").append(maxProperties);
         sb.append(", minProperties=").append(minProperties);
         sb.append(", isNullable=").append(isNullable);
+        sb.append(", isDeprecated=").append(isDeprecated);
         sb.append(", required=").append(required);
         sb.append(", maximum='").append(maximum).append('\'');
         sb.append(", exclusiveMaximum=").append(exclusiveMaximum);

modules/openapi-generator/src/main/java/org/openapitools/codegen/DefaultCodegen.java

@@ -4334,6 +4334,9 @@ public class DefaultCodegen implements CodegenConfig {
         if (parameter.getRequired() != null) {
             codegenParameter.required = parameter.getRequired();
         }
+        if (parameter.getDeprecated() != null) {
+            codegenParameter.isDeprecated = parameter.getDeprecated();
+        }
         codegenParameter.jsonSchema = Json.pretty(parameter);
 
         if (GlobalSettings.getProperty("debugParser") != null) {

modules/openapi-generator/src/main/resources/go-echo-server/api.mustache

@@ -7,6 +7,9 @@ import (
 ){{#operation}}
 
 // {{nickname}} - {{{summary}}}
+{{#isDeprecated}}
+// Deprecated
+{{/isDeprecated}}
 func (c *Container) {{operationId}}(ctx echo.Context) error {
     return ctx.JSON(http.StatusOK, models.HelloWorld {
         Message: "Hello World",

modules/openapi-generator/src/main/resources/go-echo-server/main.mustache

@@ -17,7 +17,7 @@ func main() {
 	e.Use(middleware.Recover())
 	
 {{#apiInfo}}{{#apis}}{{#operations}}{{#operation}}
-    // {{nickname}} - {{{summary}}}
+	// {{nickname}} - {{{summary}}}{{#isDeprecated}} (deprecated){{/isDeprecated}}
 	e.{{httpMethod.toUpperCase}}("{{{basePathWithoutHost}}}{{{path}}}", c.{{operationId}})
 {{/operation}}{{/operations}}{{/apis}}{{/apiInfo}}
 

modules/openapi-generator/src/main/resources/go-echo-server/model.mustache

@@ -18,6 +18,9 @@ const (
 type {{classname}} struct {
 {{#vars}}{{#description}}
 	// {{{description}}}{{/description}}
+	{{#deprecated}}
+	// Deprecated
+	{{/deprecated}}
 	{{name}} {{#isNullable}}*{{/isNullable}}{{{dataType}}} `json:"{{baseName}}{{^required}},omitempty{{/required}}"{{#vendorExtensions.x-go-custom-tag}} {{{.}}}{{/vendorExtensions.x-go-custom-tag}}`
 {{/vars}}
 }{{/isEnum}}{{/model}}{{/models}}

modules/openapi-generator/src/main/resources/go-gin-server/controller-api.mustache

@@ -9,6 +9,9 @@ import (
 ){{#operation}}
 
 // {{nickname}} - {{{summary}}}
+{{#isDeprecated}}
+// Deprecated
+{{/isDeprecated}}
 func {{nickname}}(c *gin.Context) {
 	c.JSON(http.StatusOK, gin.H{})
 }{{/operation}}{{/operations}}

modules/openapi-generator/src/main/resources/go-gin-server/model.mustache

@@ -19,6 +19,9 @@ const (
 type {{classname}} struct {
 {{#vars}}{{#description}}
 	// {{{description}}}{{/description}}
+	{{#deprecated}}
+	// Deprecated
+	{{/deprecated}}
 	{{name}} {{#isNullable}}*{{/isNullable}}{{{dataType}}} `json:"{{baseName}}{{^required}},omitempty{{/required}}"{{#vendorExtensions.x-go-custom-tag}} {{{.}}}{{/vendorExtensions.x-go-custom-tag}}`
 {{/vars}}
 }{{/isEnum}}{{/model}}{{/models}}

modules/openapi-generator/src/main/resources/go-server/api.mustache

@@ -13,6 +13,9 @@ import (
 // The {{classname}}Router implementation should parse necessary information from the http request, 
 // pass the data to a {{classname}}Servicer to perform the required actions, then write the service results to the http response.
 type {{classname}}Router interface { {{#operations}}{{#operation}}
+	{{#isDeprecated}}
+	// Deprecated
+	{{/isDeprecated}}
 	{{operationId}}(http.ResponseWriter, *http.Request){{/operation}}{{/operations}}
 }{{/apis}}{{/apiInfo}}{{#apiInfo}}{{#apis}}
 
@@ -22,5 +25,8 @@ type {{classname}}Router interface { {{#operations}}{{#operation}}
 // while the service implementation can ignored with the .openapi-generator-ignore file 
 // and updated with the logic required for the API.
 type {{classname}}Servicer interface { {{#operations}}{{#operation}}
+	{{#isDeprecated}}
+	// Deprecated
+	{{/isDeprecated}}
 	{{operationId}}(context.Context{{#allParams}}, {{dataType}}{{/allParams}}) (ImplResponse, error){{/operation}}{{/operations}}
 }{{/apis}}{{/apiInfo}}

modules/openapi-generator/src/main/resources/go-server/controller-api.mustache

@@ -59,6 +59,9 @@ func (c *{{classname}}Controller) Routes() Routes {
 }{{#operations}}{{#operation}}
 
 // {{nickname}} - {{{summary}}}
+{{#isDeprecated}}
+// Deprecated
+{{/isDeprecated}}
 func (c *{{classname}}Controller) {{nickname}}(w http.ResponseWriter, r *http.Request) {
 	{{#hasFormParams}}
 	{{#isMultipart}}

modules/openapi-generator/src/main/resources/go-server/model.mustache

@@ -29,6 +29,9 @@ type {{classname}} struct {
 {{/parent}}
 {{#vars}}{{#description}}
 	// {{{description}}}{{/description}}
+	{{#deprecated}}
+	// Deprecated
+	{{/deprecated}}
 	{{name}} {{#isNullable}}*{{/isNullable}}{{{dataType}}} `json:"{{baseName}}{{^required}},omitempty{{/required}}"{{#vendorExtensions.x-go-custom-tag}} {{{.}}}{{/vendorExtensions.x-go-custom-tag}}`
 {{/vars}}
 }{{/isEnum}}{{/model}}{{/models}}

modules/openapi-generator/src/main/resources/go-server/service.mustache

@@ -20,6 +20,9 @@ func New{{classname}}Service() {{classname}}Servicer {
 }{{#operations}}{{#operation}}
 
 // {{nickname}} - {{summary}}
+{{#isDeprecated}}
+// Deprecated
+{{/isDeprecated}}
 func (s *{{classname}}Service) {{nickname}}(ctx context.Context{{#allParams}}, {{paramName}} {{dataType}}{{/allParams}}) (ImplResponse, error) {
 	// TODO - update {{nickname}} with the required logic for this service method.
 	// Add {{classFilename}}_service.go to the .openapi-generator-ignore to avoid overwriting this service implementation when updating open api generation.

modules/openapi-generator/src/main/resources/go/README.mustache

@@ -86,7 +86,7 @@ All URIs are relative to *{{basePath}}*
 
 Class | Method | HTTP request | Description
 ------------ | ------------- | ------------- | -------------
-{{#apiInfo}}{{#apis}}{{#operations}}{{#operation}}*{{classname}}* | [**{{operationId}}**]({{apiDocPath}}{{classname}}.md#{{operationIdLowerCase}}) | **{{httpMethod}}** {{path}} | {{#summary}}{{summary}}{{/summary}}
+{{#apiInfo}}{{#apis}}{{#operations}}{{#operation}}*{{classname}}* | [**{{operationId}}**]({{apiDocPath}}{{classname}}.md#{{operationIdLowerCase}}) | **{{httpMethod}}** {{path}} | {{summary}}
 {{/operation}}{{/operations}}{{/apis}}{{/apiInfo}}
 
 ## Documentation For Models

modules/openapi-generator/src/main/resources/go/api.mustache

@@ -22,20 +22,27 @@ type {{classname}} interface {
 	{{#operation}}
 
 	/*
-	 * {{operationId}}{{#summary}} {{{.}}}{{/summary}}{{^summary}} Method for {{operationId}}{{/summary}}
+	{{operationId}} {{{summary}}}{{^summary}}Method for {{operationId}}{{/summary}}
 	{{#notes}}
-	 * {{{unescapedNotes}}}
+
+	{{{unescapedNotes}}}
 	{{/notes}}
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().{{#pathParams}}
-	 * @param {{paramName}}{{#description}} {{{.}}}{{/description}}{{/pathParams}}
-	 * @return {{#structPrefix}}{{&classname}}{{/structPrefix}}Api{{operationId}}Request
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().{{#pathParams}}
+	 @param {{paramName}}{{#description}} {{{.}}}{{/description}}{{/pathParams}}
+	 @return {{#structPrefix}}{{&classname}}{{/structPrefix}}Api{{operationId}}Request
+	{{#isDeprecated}}
+
+	Deprecated
+	{{/isDeprecated}}
 	*/
 	{{{nickname}}}(ctx _context.Context{{#pathParams}}, {{paramName}} {{{dataType}}}{{/pathParams}}) {{#structPrefix}}{{&classname}}{{/structPrefix}}Api{{operationId}}Request
 
-	/*
-	 * {{nickname}}Execute executes the request{{#returnType}}
-	 * @return {{{.}}}{{/returnType}}
-	 */
+	// {{nickname}}Execute executes the request{{#returnType}}
+	//  @return {{{.}}}{{/returnType}}
+	{{#isDeprecated}}
+	// Deprecated
+	{{/isDeprecated}}
 	{{nickname}}Execute(r {{#structPrefix}}{{&classname}}{{/structPrefix}}Api{{operationId}}Request) ({{#returnType}}{{{.}}}, {{/returnType}}*_nethttp.Response, error)
 	{{/operation}}
 }
@@ -46,16 +53,19 @@ type {{classname}}Service service
 {{#operation}}
 
 type {{#structPrefix}}{{&classname}}{{/structPrefix}}Api{{operationId}}Request struct {
-	ctx _context.Context{{#generateInterfaces}}
-	ApiService {{classname}}
-{{/generateInterfaces}}{{^generateInterfaces}}
-	ApiService *{{classname}}Service
-{{/generateInterfaces}}
+	ctx _context.Context
+	ApiService {{#generateInterfaces}}{{classname}}{{/generateInterfaces}}{{^generateInterfaces}}*{{classname}}Service{{/generateInterfaces}}
 {{#allParams}}
 	{{paramName}} {{^isPathParam}}*{{/isPathParam}}{{{dataType}}}
 {{/allParams}}
 }
 {{#allParams}}{{^isPathParam}}
+{{#description}}
+// {{.}}
+{{/description}}
+{{#isDeprecated}}
+// Deprecated
+{{/isDeprecated}}
 func (r {{#structPrefix}}{{&classname}}{{/structPrefix}}Api{{operationId}}Request) {{vendorExtensions.x-export-param-name}}({{paramName}} {{{dataType}}}) {{#structPrefix}}{{&classname}}{{/structPrefix}}Api{{operationId}}Request {
 	r.{{paramName}} = &{{paramName}}
 	return r
@@ -66,14 +76,20 @@ func (r {{#structPrefix}}{{&classname}}{{/structPrefix}}Api{{operationId}}Reques
 }
 
 /*
- * {{operationId}}{{#summary}} {{{.}}}{{/summary}}{{^summary}} Method for {{operationId}}{{/summary}}
+{{operationId}} {{{summary}}}{{^summary}}Method for {{operationId}}{{/summary}}
 {{#notes}}
- * {{{unescapedNotes}}}
+
+{{{unescapedNotes}}}
 {{/notes}}
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().{{#pathParams}}
- * @param {{paramName}}{{#description}} {{{.}}}{{/description}}{{/pathParams}}
- * @return {{#structPrefix}}{{&classname}}{{/structPrefix}}Api{{operationId}}Request
- */
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().{{#pathParams}}
+ @param {{paramName}}{{#description}} {{{.}}}{{/description}}{{/pathParams}}
+ @return {{#structPrefix}}{{&classname}}{{/structPrefix}}Api{{operationId}}Request
+{{#isDeprecated}}
+
+Deprecated
+{{/isDeprecated}}
+*/
 func (a *{{{classname}}}Service) {{{nickname}}}(ctx _context.Context{{#pathParams}}, {{paramName}} {{{dataType}}}{{/pathParams}}) {{#structPrefix}}{{&classname}}{{/structPrefix}}Api{{operationId}}Request {
 	return {{#structPrefix}}{{&classname}}{{/structPrefix}}Api{{operationId}}Request{
 		ApiService: a,
@@ -84,10 +100,11 @@ func (a *{{{classname}}}Service) {{{nickname}}}(ctx _context.Context{{#pathParam
 	}
 }
 
-/*
- * Execute executes the request{{#returnType}}
- * @return {{{.}}}{{/returnType}}
- */
+// Execute executes the request{{#returnType}}
+//  @return {{{.}}}{{/returnType}}
+{{#isDeprecated}}
+// Deprecated
+{{/isDeprecated}}
 func (a *{{{classname}}}Service) {{nickname}}Execute(r {{#structPrefix}}{{&classname}}{{/structPrefix}}Api{{operationId}}Request) ({{#returnType}}{{{.}}}, {{/returnType}}*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.Method{{httpMethod}}
@@ -106,7 +123,7 @@ func (a *{{{classname}}}Service) {{nickname}}Execute(r {{#structPrefix}}{{&class
 	}
 
 	localVarPath := localBasePath + "{{{path}}}"{{#pathParams}}
-	localVarPath = strings.Replace(localVarPath, "{"+"{{baseName}}"+"}", _neturl.PathEscape(parameterToString(r.{{paramName}}, "{{#collectionFormat}}{{collectionFormat}}{{/collectionFormat}}")), -1){{/pathParams}}
+	localVarPath = strings.Replace(localVarPath, "{"+"{{baseName}}"+"}", _neturl.PathEscape(parameterToString(r.{{paramName}}, "{{collectionFormat}}")), -1){{/pathParams}}
 
 	localVarHeaderParams := make(map[string]string)
 	localVarQueryParams := _neturl.Values{}
@@ -171,15 +188,15 @@ func (a *{{{classname}}}Service) {{nickname}}Execute(r {{#structPrefix}}{{&class
 		if reflect.TypeOf(t).Kind() == reflect.Slice {
 			s := reflect.ValueOf(t)
 			for i := 0; i < s.Len(); i++ {
-				localVarQueryParams.Add("{{baseName}}", parameterToString(s.Index(i), "{{#collectionFormat}}{{collectionFormat}}{{/collectionFormat}}"))
+				localVarQueryParams.Add("{{baseName}}", parameterToString(s.Index(i), "{{collectionFormat}}"))
 			}
 		} else {
-			localVarQueryParams.Add("{{baseName}}", parameterToString(t, "{{#collectionFormat}}{{collectionFormat}}{{/collectionFormat}}"))
+			localVarQueryParams.Add("{{baseName}}", parameterToString(t, "{{collectionFormat}}"))
 		}
 	}
 	{{/isCollectionFormatMulti}}
 	{{^isCollectionFormatMulti}}
-	localVarQueryParams.Add("{{baseName}}", parameterToString(*r.{{paramName}}, "{{#collectionFormat}}{{collectionFormat}}{{/collectionFormat}}"))
+	localVarQueryParams.Add("{{baseName}}", parameterToString(*r.{{paramName}}, "{{collectionFormat}}"))
 	{{/isCollectionFormatMulti}}
 	{{/required}}
 	{{^required}}
@@ -189,14 +206,14 @@ func (a *{{{classname}}}Service) {{nickname}}Execute(r {{#structPrefix}}{{&class
 		if reflect.TypeOf(t).Kind() == reflect.Slice {
 			s := reflect.ValueOf(t)
 			for i := 0; i < s.Len(); i++ {
-				localVarQueryParams.Add("{{baseName}}", parameterToString(s.Index(i), "{{#collectionFormat}}{{collectionFormat}}{{/collectionFormat}}"))
+				localVarQueryParams.Add("{{baseName}}", parameterToString(s.Index(i), "{{collectionFormat}}"))
 			}
 		} else {
-			localVarQueryParams.Add("{{baseName}}", parameterToString(t, "{{#collectionFormat}}{{collectionFormat}}{{/collectionFormat}}"))
+			localVarQueryParams.Add("{{baseName}}", parameterToString(t, "{{collectionFormat}}"))
 		}
 	{{/isCollectionFormatMulti}}
 	{{^isCollectionFormatMulti}}
-		localVarQueryParams.Add("{{baseName}}", parameterToString(*r.{{paramName}}, "{{#collectionFormat}}{{collectionFormat}}{{/collectionFormat}}"))
+		localVarQueryParams.Add("{{baseName}}", parameterToString(*r.{{paramName}}, "{{collectionFormat}}"))
 	{{/isCollectionFormatMulti}}
 	}
 	{{/required}}
@@ -224,11 +241,11 @@ func (a *{{{classname}}}Service) {{nickname}}Execute(r {{#structPrefix}}{{&class
 	}
 {{#headerParams}}
 	{{#required}}
-	localVarHeaderParams["{{baseName}}"] = parameterToString(*r.{{paramName}}, "{{#collectionFormat}}{{collectionFormat}}{{/collectionFormat}}")
+	localVarHeaderParams["{{baseName}}"] = parameterToString(*r.{{paramName}}, "{{collectionFormat}}")
 	{{/required}}
 	{{^required}}
 	if r.{{paramName}} != nil {
-		localVarHeaderParams["{{baseName}}"] = parameterToString(*r.{{paramName}}, "{{#collectionFormat}}{{collectionFormat}}{{/collectionFormat}}")
+		localVarHeaderParams["{{baseName}}"] = parameterToString(*r.{{paramName}}, "{{collectionFormat}}")
 	}
 	{{/required}}
 {{/headerParams}}
@@ -253,7 +270,7 @@ func (a *{{{classname}}}Service) {{nickname}}Execute(r {{#structPrefix}}{{&class
 {{/isFile}}
 {{^isFile}}
 {{#required}}
-	localVarFormParams.Add("{{baseName}}", parameterToString(*r.{{paramName}}, "{{#collectionFormat}}{{collectionFormat}}{{/collectionFormat}}"))
+	localVarFormParams.Add("{{baseName}}", parameterToString(*r.{{paramName}}, "{{collectionFormat}}"))
 {{/required}}
 {{^required}}
 {{#isModel}}
@@ -267,7 +284,7 @@ func (a *{{{classname}}}Service) {{nickname}}Execute(r {{#structPrefix}}{{&class
 {{/isModel}}
 {{^isModel}}
 	if r.{{paramName}} != nil {
-		localVarFormParams.Add("{{baseName}}", parameterToString(*r.{{paramName}}, "{{#collectionFormat}}{{collectionFormat}}{{/collectionFormat}}"))
+		localVarFormParams.Add("{{baseName}}", parameterToString(*r.{{paramName}}, "{{collectionFormat}}"))
 	}
 {{/isModel}}
 {{/required}}

modules/openapi-generator/src/main/resources/go/api_doc.mustache

@@ -1,12 +1,12 @@
 # {{invokerPackage}}\{{classname}}{{#description}}
 
-{{description}}{{/description}}
+{{.}}{{/description}}
 
 All URIs are relative to *{{basePath}}*
 
 Method | HTTP request | Description
 ------------- | ------------- | -------------
-{{#operations}}{{#operation}}[**{{operationId}}**]({{classname}}.md#{{operationId}}) | **{{httpMethod}}** {{path}} | {{#summary}}{{summary}}{{/summary}}
+{{#operations}}{{#operation}}[**{{operationId}}**]({{classname}}.md#{{operationId}}) | **{{httpMethod}}** {{path}} | {{summary}}
 {{/operation}}{{/operations}}
 
 {{#operations}}
@@ -60,7 +60,7 @@ func main() {
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
 **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc.{{/-last}}{{/pathParams}}{{#pathParams}}
-**{{paramName}}** | {{^isPrimitiveType}}{{^isFile}}[{{/isFile}}{{/isPrimitiveType}}**{{dataType}}**{{^isPrimitiveType}}{{^isFile}}]({{baseType}}.md){{/isFile}}{{/isPrimitiveType}} | {{description}} | {{#defaultValue}}[default to {{defaultValue}}]{{/defaultValue}}{{/pathParams}}
+**{{paramName}}** | {{^isPrimitiveType}}{{^isFile}}[{{/isFile}}{{/isPrimitiveType}}**{{dataType}}**{{^isPrimitiveType}}{{^isFile}}]({{baseType}}.md){{/isFile}}{{/isPrimitiveType}} | {{description}} | {{#defaultValue}}[default to {{.}}]{{/defaultValue}}{{/pathParams}}
 
 ### Other Parameters
 
@@ -69,7 +69,7 @@ Other parameters are passed through a pointer to a api{{{nickname}}}Request stru
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------{{/-last}}{{/allParams}}{{#allParams}}
-{{^isPathParam}} **{{paramName}}** | {{#isContainer}}{{#isArray}}{{#items}}{{^isPrimitiveType}}{{^isFile}}[{{/isFile}}{{/isPrimitiveType}}**[]{{dataType}}**{{^isPrimitiveType}}{{^isFile}}]({{^baseType}}{{dataType}}{{/baseType}}{{baseType}}.md){{/isFile}}{{/isPrimitiveType}}{{/items}}{{/isArray}}{{#isMap}}{{#items}}{{^isPrimitiveType}}{{^isFile}}[{{/isFile}}{{/isPrimitiveType}}**map[string]{{dataType}}**{{^isPrimitiveType}}{{^isFile}}]({{^baseType}}{{dataType}}{{/baseType}}{{baseType}}.md){{/isFile}}{{/isPrimitiveType}}{{/items}}{{/isMap}}{{/isContainer}}{{^isContainer}}{{^isPrimitiveType}}{{^isFile}}[{{/isFile}}{{/isPrimitiveType}}**{{dataType}}**{{^isPrimitiveType}}{{^isFile}}]({{^baseType}}{{dataType}}{{/baseType}}{{baseType}}.md){{/isFile}}{{/isPrimitiveType}}{{/isContainer}} | {{description}} | {{#defaultValue}}[default to {{defaultValue}}]{{/defaultValue}}{{/isPathParam}}{{/allParams}}
+{{^isPathParam}} **{{paramName}}** | {{#isContainer}}{{#isArray}}{{#items}}{{^isPrimitiveType}}{{^isFile}}[{{/isFile}}{{/isPrimitiveType}}**[]{{dataType}}**{{^isPrimitiveType}}{{^isFile}}]({{^baseType}}{{dataType}}{{/baseType}}{{baseType}}.md){{/isFile}}{{/isPrimitiveType}}{{/items}}{{/isArray}}{{#isMap}}{{#items}}{{^isPrimitiveType}}{{^isFile}}[{{/isFile}}{{/isPrimitiveType}}**map[string]{{dataType}}**{{^isPrimitiveType}}{{^isFile}}]({{^baseType}}{{dataType}}{{/baseType}}{{baseType}}.md){{/isFile}}{{/isPrimitiveType}}{{/items}}{{/isMap}}{{/isContainer}}{{^isContainer}}{{^isPrimitiveType}}{{^isFile}}[{{/isFile}}{{/isPrimitiveType}}**{{dataType}}**{{^isPrimitiveType}}{{^isFile}}]({{^baseType}}{{dataType}}{{/baseType}}{{baseType}}.md){{/isFile}}{{/isPrimitiveType}}{{/isContainer}} | {{description}} | {{#defaultValue}}[default to {{.}}]{{/defaultValue}}{{/isPathParam}}{{/allParams}}
 
 ### Return type
 

modules/openapi-generator/src/main/resources/go/client.mustache

@@ -47,12 +47,7 @@ type APIClient struct {
 {{#apis}}
 {{#operations}}
 
-  {{#generateInterfaces}}
-	{{classname}} {{classname}}
-  {{/generateInterfaces}}
-  {{^generateInterfaces}}
-	{{classname}} *{{classname}}Service
-  {{/generateInterfaces}}
+	{{classname}} {{#generateInterfaces}}{{classname}}{{/generateInterfaces}}{{^generateInterfaces}}*{{classname}}Service{{/generateInterfaces}}
 {{/operations}}
 {{/apis}}
 {{/apiInfo}}

modules/openapi-generator/src/main/resources/go/configuration.mustache

@@ -117,7 +117,7 @@ type Configuration struct {
 func NewConfiguration() *Configuration {
 	cfg := &Configuration{
 		DefaultHeader:    make(map[string]string),
-		UserAgent:        "{{#httpUserAgent}}{{{.}}}{{/httpUserAgent}}{{^httpUserAgent}}OpenAPI-Generator/{{{packageVersion}}}/go{{/httpUserAgent}}",
+		UserAgent:        "{{{httpUserAgent}}}{{^httpUserAgent}}OpenAPI-Generator/{{{packageVersion}}}/go{{/httpUserAgent}}",
 		Debug:            false,
 		{{#servers}}
 		{{#-first}}

modules/openapi-generator/src/main/resources/go/model_anyof.mustache

@@ -1,4 +1,4 @@
-// {{classname}}{{#description}} {{{description}}}{{/description}}{{^description}} struct for {{{classname}}}{{/description}}
+// {{classname}} {{{description}}}{{^description}}struct for {{{classname}}}{{/description}}
 type {{classname}} struct {
 	{{#anyOf}}
 	{{{.}}} *{{{.}}}

modules/openapi-generator/src/main/resources/go/model_enum.mustache

@@ -1,5 +1,5 @@
-// {{{classname}}} {{#description}}{{{.}}}{{/description}}{{^description}}the model '{{{classname}}}'{{/description}}
-type {{{classname}}} {{^format}}{{dataType}}{{/format}}{{#format}}{{{format}}}{{/format}}
+// {{{classname}}} {{{description}}}{{^description}}the model '{{{classname}}}'{{/description}}
+type {{{classname}}} {{{format}}}{{^format}}{{dataType}}{{/format}}
 
 // List of {{{name}}}
 const (
@@ -21,7 +21,7 @@ var allowed{{{classname}}}EnumValues = []{{{classname}}}{
 }
 
 func (v *{{{classname}}}) UnmarshalJSON(src []byte) error {
-	var value {{^format}}{{dataType}}{{/format}}{{#format}}{{{format}}}{{/format}}
+	var value {{{format}}}{{^format}}{{dataType}}{{/format}}
 	err := json.Unmarshal(src, &value)
 	if err != nil {
 		return err
@@ -39,7 +39,7 @@ func (v *{{{classname}}}) UnmarshalJSON(src []byte) error {
 
 // New{{{classname}}}FromValue returns a pointer to a valid {{{classname}}}
 // for the value passed as argument, or an error if the value passed is not allowed by the enum
-func New{{{classname}}}FromValue(v {{^format}}{{dataType}}{{/format}}{{#format}}{{{format}}}{{/format}}) (*{{{classname}}}, error) {
+func New{{{classname}}}FromValue(v {{{format}}}{{^format}}{{dataType}}{{/format}}) (*{{{classname}}}, error) {
 	ev := {{{classname}}}(v)
 	if ev.IsValid() {
 		return &ev, nil

modules/openapi-generator/src/main/resources/go/model_oneof.mustache

@@ -1,4 +1,4 @@
-// {{classname}} - {{#description}}{{{description}}}{{/description}}{{^description}}struct for {{{classname}}}{{/description}}
+// {{classname}} - {{{description}}}{{^description}}struct for {{{classname}}}{{/description}}
 type {{classname}} struct {
 	{{#oneOf}}
 	{{{.}}} *{{{.}}}

modules/openapi-generator/src/main/resources/go/model_simple.mustache

@@ -1,4 +1,4 @@
-// {{classname}}{{#description}} {{{description}}}{{/description}}{{^description}} struct for {{{classname}}}{{/description}}
+// {{classname}} {{{description}}}{{^description}}struct for {{{classname}}}{{/description}}
 type {{classname}} struct {
 {{#parent}}
 {{^isMap}}
@@ -16,6 +16,9 @@ type {{classname}} struct {
 {{#description}}
 	// {{{description}}}
 {{/description}}
+{{#deprecated}}
+	// Deprecated
+{{/deprecated}}
 	{{name}} {{^required}}{{^isNullable}}*{{/isNullable}}{{/required}}{{{dataType}}} `json:"{{baseName}}{{^required}},omitempty{{/required}}"{{#withXml}} xml:"{{baseName}}{{#isXmlAttribute}},attr{{/isXmlAttribute}}"{{/withXml}}{{#vendorExtensions.x-go-custom-tag}} {{{.}}}{{/vendorExtensions.x-go-custom-tag}}`
 {{/vars}}
 {{#isAdditionalPropertiesTrue}}
@@ -84,6 +87,9 @@ func New{{classname}}WithDefaults() *{{classname}} {
 {{#isNullable}}
 // If the value is explicit nil, the zero value for {{vendorExtensions.x-go-base-type}} will be returned
 {{/isNullable}}
+{{#deprecated}}
+// Deprecated
+{{/deprecated}}
 func (o *{{classname}}) Get{{name}}() {{vendorExtensions.x-go-base-type}} {
 	if o == nil{{#isNullable}}{{^vendorExtensions.x-golang-is-container}} || o.{{name}}.Get() == nil{{/vendorExtensions.x-golang-is-container}}{{/isNullable}} {
 		var ret {{vendorExtensions.x-go-base-type}}
@@ -108,6 +114,9 @@ func (o *{{classname}}) Get{{name}}() {{vendorExtensions.x-go-base-type}} {
 {{#isNullable}}
 // NOTE: If the value is an explicit nil, `nil, true` will be returned
 {{/isNullable}}
+{{#deprecated}}
+// Deprecated
+{{/deprecated}}
 func (o *{{classname}}) Get{{name}}Ok() (*{{vendorExtensions.x-go-base-type}}, bool) {
 	if o == nil {{#isNullable}}{{#vendorExtensions.x-golang-is-container}}|| o.{{name}} == nil{{/vendorExtensions.x-golang-is-container}}{{/isNullable}} {
 		return nil, false
@@ -126,6 +135,9 @@ func (o *{{classname}}) Get{{name}}Ok() (*{{vendorExtensions.x-go-base-type}}, b
 }
 
 // Set{{name}} sets field value
+{{#deprecated}}
+// Deprecated
+{{/deprecated}}
 func (o *{{classname}}) Set{{name}}(v {{vendorExtensions.x-go-base-type}}) {
 {{#isNullable}}
 {{#vendorExtensions.x-golang-is-container}}
@@ -143,6 +155,9 @@ func (o *{{classname}}) Set{{name}}(v {{vendorExtensions.x-go-base-type}}) {
 {{/required}}
 {{^required}}
 // Get{{name}} returns the {{name}} field value if set, zero value otherwise{{#isNullable}} (both if not set or set to explicit null){{/isNullable}}.
+{{#deprecated}}
+// Deprecated
+{{/deprecated}}
 func (o *{{classname}}) Get{{name}}() {{vendorExtensions.x-go-base-type}} {
 	if o == nil {{^isNullable}}|| o.{{name}} == nil{{/isNullable}}{{#isNullable}}{{^vendorExtensions.x-golang-is-container}}|| o.{{name}}.Get() == nil{{/vendorExtensions.x-golang-is-container}}{{/isNullable}} {
 		var ret {{vendorExtensions.x-go-base-type}}
@@ -166,6 +181,9 @@ func (o *{{classname}}) Get{{name}}() {{vendorExtensions.x-go-base-type}} {
 {{#isNullable}}
 // NOTE: If the value is an explicit nil, `nil, true` will be returned
 {{/isNullable}}
+{{#deprecated}}
+// Deprecated
+{{/deprecated}}
 func (o *{{classname}}) Get{{name}}Ok() (*{{vendorExtensions.x-go-base-type}}, bool) {
 	if o == nil {{^isNullable}}|| o.{{name}} == nil{{/isNullable}}{{#isNullable}}{{#vendorExtensions.x-golang-is-container}}|| o.{{name}} == nil{{/vendorExtensions.x-golang-is-container}}{{/isNullable}} {
 		return nil, false
@@ -193,6 +211,9 @@ func (o *{{classname}}) Has{{name}}() bool {
 }
 
 // Set{{name}} gets a reference to the given {{dataType}} and assigns it to the {{name}} field.
+{{#deprecated}}
+// Deprecated
+{{/deprecated}}
 func (o *{{classname}}) Set{{name}}(v {{vendorExtensions.x-go-base-type}}) {
 {{#isNullable}}
 {{#vendorExtensions.x-golang-is-container}}
@@ -286,6 +307,9 @@ func (o *{{{classname}}}) UnmarshalJSON(bytes []byte) (err error) {
 	{{#description}}
 		// {{{description}}}
 	{{/description}}
+	{{#deprecated}}
+		// Deprecated
+	{{/deprecated}}
 		{{name}} {{^required}}{{^isNullable}}*{{/isNullable}}{{/required}}{{{dataType}}} `json:"{{baseName}}{{^required}},omitempty{{/required}}"{{#withXml}} xml:"{{baseName}}{{#isXmlAttribute}},attr{{/isXmlAttribute}}"{{/withXml}}{{#vendorExtensions.x-go-custom-tag}} {{{.}}}{{/vendorExtensions.x-go-custom-tag}}`
 	{{/vars}}
 	}

modules/openapi-generator/src/main/resources/go/partial_header.mustache

@@ -1,18 +1,18 @@
 /*
- {{#appName}}
- * {{{appName}}}
- *
- {{/appName}}
- {{#appDescription}}
- * {{{appDescription}}}
- *
- {{/appDescription}}
- {{#version}}
- * API version: {{{version}}}
- {{/version}}
- {{#infoEmail}}
- * Contact: {{{infoEmail}}}
- {{/infoEmail}}
- */
+{{#appName}}
+{{{.}}}
+
+{{/appName}}
+{{#appDescription}}
+{{{.}}}
+
+{{/appDescription}}
+{{#version}}
+API version: {{{.}}}
+{{/version}}
+{{#infoEmail}}
+Contact: {{{.}}}
+{{/infoEmail}}
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.

modules/openapi-generator/src/test/resources/2_0/petstore-with-fake-endpoints-models-for-testing.yaml

@@ -1252,6 +1252,7 @@ definitions:
       status:
         type: string
         description: pet status in the store
+        deprecated: true
         enum:
           - available
           - pending

modules/openapi-generator/src/test/resources/3_0/petstore-with-fake-endpoints-models-for-testing-with-http-signature.yaml

@@ -83,6 +83,7 @@ paths:
           required: true
           style: form
           explode: false
+          deprecated: true
           schema:
             type: array
             items:
@@ -1346,6 +1347,7 @@ components:
         status:
           type: string
           description: pet status in the store
+          deprecated: true
           enum:
             - available
             - pending

modules/openapi-generator/src/test/resources/3_0/petstore.yaml

@@ -85,6 +85,7 @@ paths:
           required: true
           style: form
           explode: false
+          deprecated: true
           schema:
             type: array
             items:
@@ -716,6 +717,7 @@ components:
         status:
           type: string
           description: pet status in the store
+          deprecated: true
           enum:
             - available
             - pending

samples/client/petstore/go/go-petstore/api_another_fake.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 
@@ -26,17 +26,17 @@ var (
 type AnotherFakeApi interface {
 
 	/*
-	 * Call123TestSpecialTags To test special tags
-	 * To test special tags and operation ID starting with number
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiCall123TestSpecialTagsRequest
+	Call123TestSpecialTags To test special tags
+
+	To test special tags and operation ID starting with number
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiCall123TestSpecialTagsRequest
 	*/
 	Call123TestSpecialTags(ctx _context.Context) ApiCall123TestSpecialTagsRequest
 
-	/*
-	 * Call123TestSpecialTagsExecute executes the request
-	 * @return Client
-	 */
+	// Call123TestSpecialTagsExecute executes the request
+	//  @return Client
 	Call123TestSpecialTagsExecute(r ApiCall123TestSpecialTagsRequest) (Client, *_nethttp.Response, error)
 }
 
@@ -49,6 +49,7 @@ type ApiCall123TestSpecialTagsRequest struct {
 	body *Client
 }
 
+// client model
 func (r ApiCall123TestSpecialTagsRequest) Body(body Client) ApiCall123TestSpecialTagsRequest {
 	r.body = &body
 	return r
@@ -59,11 +60,13 @@ func (r ApiCall123TestSpecialTagsRequest) Execute() (Client, *_nethttp.Response,
 }
 
 /*
- * Call123TestSpecialTags To test special tags
- * To test special tags and operation ID starting with number
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiCall123TestSpecialTagsRequest
- */
+Call123TestSpecialTags To test special tags
+
+To test special tags and operation ID starting with number
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiCall123TestSpecialTagsRequest
+*/
 func (a *AnotherFakeApiService) Call123TestSpecialTags(ctx _context.Context) ApiCall123TestSpecialTagsRequest {
 	return ApiCall123TestSpecialTagsRequest{
 		ApiService: a,
@@ -71,10 +74,8 @@ func (a *AnotherFakeApiService) Call123TestSpecialTags(ctx _context.Context) Api
 	}
 }
 
-/*
- * Execute executes the request
- * @return Client
- */
+// Execute executes the request
+//  @return Client
 func (a *AnotherFakeApiService) Call123TestSpecialTagsExecute(r ApiCall123TestSpecialTagsRequest) (Client, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPatch

samples/client/petstore/go/go-petstore/api_fake.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 
@@ -29,190 +29,187 @@ var (
 type FakeApi interface {
 
 	/*
-	 * CreateXmlItem creates an XmlItem
-	 * this route creates an XmlItem
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiCreateXmlItemRequest
+	CreateXmlItem creates an XmlItem
+
+	this route creates an XmlItem
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiCreateXmlItemRequest
 	*/
 	CreateXmlItem(ctx _context.Context) ApiCreateXmlItemRequest
 
-	/*
-	 * CreateXmlItemExecute executes the request
-	 */
+	// CreateXmlItemExecute executes the request
 	CreateXmlItemExecute(r ApiCreateXmlItemRequest) (*_nethttp.Response, error)
 
 	/*
-	 * FakeOuterBooleanSerialize Method for FakeOuterBooleanSerialize
-	 * Test serialization of outer boolean types
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiFakeOuterBooleanSerializeRequest
+	FakeOuterBooleanSerialize Method for FakeOuterBooleanSerialize
+
+	Test serialization of outer boolean types
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiFakeOuterBooleanSerializeRequest
 	*/
 	FakeOuterBooleanSerialize(ctx _context.Context) ApiFakeOuterBooleanSerializeRequest
 
-	/*
-	 * FakeOuterBooleanSerializeExecute executes the request
-	 * @return bool
-	 */
+	// FakeOuterBooleanSerializeExecute executes the request
+	//  @return bool
 	FakeOuterBooleanSerializeExecute(r ApiFakeOuterBooleanSerializeRequest) (bool, *_nethttp.Response, error)
 
 	/*
-	 * FakeOuterCompositeSerialize Method for FakeOuterCompositeSerialize
-	 * Test serialization of object with outer number type
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiFakeOuterCompositeSerializeRequest
+	FakeOuterCompositeSerialize Method for FakeOuterCompositeSerialize
+
+	Test serialization of object with outer number type
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiFakeOuterCompositeSerializeRequest
 	*/
 	FakeOuterCompositeSerialize(ctx _context.Context) ApiFakeOuterCompositeSerializeRequest
 
-	/*
-	 * FakeOuterCompositeSerializeExecute executes the request
-	 * @return OuterComposite
-	 */
+	// FakeOuterCompositeSerializeExecute executes the request
+	//  @return OuterComposite
 	FakeOuterCompositeSerializeExecute(r ApiFakeOuterCompositeSerializeRequest) (OuterComposite, *_nethttp.Response, error)
 
 	/*
-	 * FakeOuterNumberSerialize Method for FakeOuterNumberSerialize
-	 * Test serialization of outer number types
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiFakeOuterNumberSerializeRequest
+	FakeOuterNumberSerialize Method for FakeOuterNumberSerialize
+
+	Test serialization of outer number types
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiFakeOuterNumberSerializeRequest
 	*/
 	FakeOuterNumberSerialize(ctx _context.Context) ApiFakeOuterNumberSerializeRequest
 
-	/*
-	 * FakeOuterNumberSerializeExecute executes the request
-	 * @return float32
-	 */
+	// FakeOuterNumberSerializeExecute executes the request
+	//  @return float32
 	FakeOuterNumberSerializeExecute(r ApiFakeOuterNumberSerializeRequest) (float32, *_nethttp.Response, error)
 
 	/*
-	 * FakeOuterStringSerialize Method for FakeOuterStringSerialize
-	 * Test serialization of outer string types
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiFakeOuterStringSerializeRequest
+	FakeOuterStringSerialize Method for FakeOuterStringSerialize
+
+	Test serialization of outer string types
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiFakeOuterStringSerializeRequest
 	*/
 	FakeOuterStringSerialize(ctx _context.Context) ApiFakeOuterStringSerializeRequest
 
-	/*
-	 * FakeOuterStringSerializeExecute executes the request
-	 * @return string
-	 */
+	// FakeOuterStringSerializeExecute executes the request
+	//  @return string
 	FakeOuterStringSerializeExecute(r ApiFakeOuterStringSerializeRequest) (string, *_nethttp.Response, error)
 
 	/*
-	 * TestBodyWithFileSchema Method for TestBodyWithFileSchema
-	 * For this test, the body for this request much reference a schema named `File`.
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiTestBodyWithFileSchemaRequest
+	TestBodyWithFileSchema Method for TestBodyWithFileSchema
+
+	For this test, the body for this request much reference a schema named `File`.
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiTestBodyWithFileSchemaRequest
 	*/
 	TestBodyWithFileSchema(ctx _context.Context) ApiTestBodyWithFileSchemaRequest
 
-	/*
-	 * TestBodyWithFileSchemaExecute executes the request
-	 */
+	// TestBodyWithFileSchemaExecute executes the request
 	TestBodyWithFileSchemaExecute(r ApiTestBodyWithFileSchemaRequest) (*_nethttp.Response, error)
 
 	/*
-	 * TestBodyWithQueryParams Method for TestBodyWithQueryParams
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiTestBodyWithQueryParamsRequest
+	TestBodyWithQueryParams Method for TestBodyWithQueryParams
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiTestBodyWithQueryParamsRequest
 	*/
 	TestBodyWithQueryParams(ctx _context.Context) ApiTestBodyWithQueryParamsRequest
 
-	/*
-	 * TestBodyWithQueryParamsExecute executes the request
-	 */
+	// TestBodyWithQueryParamsExecute executes the request
 	TestBodyWithQueryParamsExecute(r ApiTestBodyWithQueryParamsRequest) (*_nethttp.Response, error)
 
 	/*
-	 * TestClientModel To test \"client\" model
-	 * To test "client" model
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiTestClientModelRequest
+	TestClientModel To test \"client\" model
+
+	To test "client" model
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiTestClientModelRequest
 	*/
 	TestClientModel(ctx _context.Context) ApiTestClientModelRequest
 
-	/*
-	 * TestClientModelExecute executes the request
-	 * @return Client
-	 */
+	// TestClientModelExecute executes the request
+	//  @return Client
 	TestClientModelExecute(r ApiTestClientModelRequest) (Client, *_nethttp.Response, error)
 
 	/*
-	 * TestEndpointParameters Fake endpoint for testing various parameters  假端點  偽のエンドポイント  가짜 엔드 포인트
-	 * Fake endpoint for testing various parameters
+	TestEndpointParameters Fake endpoint for testing various parameters  假端點  偽のエンドポイント  가짜 엔드 포인트
+
+	Fake endpoint for testing various parameters
  假端點
  偽のエンドポイント
  가짜 엔드 포인트
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiTestEndpointParametersRequest
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiTestEndpointParametersRequest
 	*/
 	TestEndpointParameters(ctx _context.Context) ApiTestEndpointParametersRequest
 
-	/*
-	 * TestEndpointParametersExecute executes the request
-	 */
+	// TestEndpointParametersExecute executes the request
 	TestEndpointParametersExecute(r ApiTestEndpointParametersRequest) (*_nethttp.Response, error)
 
 	/*
-	 * TestEnumParameters To test enum parameters
-	 * To test enum parameters
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiTestEnumParametersRequest
+	TestEnumParameters To test enum parameters
+
+	To test enum parameters
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiTestEnumParametersRequest
 	*/
 	TestEnumParameters(ctx _context.Context) ApiTestEnumParametersRequest
 
-	/*
-	 * TestEnumParametersExecute executes the request
-	 */
+	// TestEnumParametersExecute executes the request
 	TestEnumParametersExecute(r ApiTestEnumParametersRequest) (*_nethttp.Response, error)
 
 	/*
-	 * TestGroupParameters Fake endpoint to test group parameters (optional)
-	 * Fake endpoint to test group parameters (optional)
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiTestGroupParametersRequest
+	TestGroupParameters Fake endpoint to test group parameters (optional)
+
+	Fake endpoint to test group parameters (optional)
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiTestGroupParametersRequest
 	*/
 	TestGroupParameters(ctx _context.Context) ApiTestGroupParametersRequest
 
-	/*
-	 * TestGroupParametersExecute executes the request
-	 */
+	// TestGroupParametersExecute executes the request
 	TestGroupParametersExecute(r ApiTestGroupParametersRequest) (*_nethttp.Response, error)
 
 	/*
-	 * TestInlineAdditionalProperties test inline additionalProperties
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiTestInlineAdditionalPropertiesRequest
+	TestInlineAdditionalProperties test inline additionalProperties
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiTestInlineAdditionalPropertiesRequest
 	*/
 	TestInlineAdditionalProperties(ctx _context.Context) ApiTestInlineAdditionalPropertiesRequest
 
-	/*
-	 * TestInlineAdditionalPropertiesExecute executes the request
-	 */
+	// TestInlineAdditionalPropertiesExecute executes the request
 	TestInlineAdditionalPropertiesExecute(r ApiTestInlineAdditionalPropertiesRequest) (*_nethttp.Response, error)
 
 	/*
-	 * TestJsonFormData test json serialization of form data
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiTestJsonFormDataRequest
+	TestJsonFormData test json serialization of form data
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiTestJsonFormDataRequest
 	*/
 	TestJsonFormData(ctx _context.Context) ApiTestJsonFormDataRequest
 
-	/*
-	 * TestJsonFormDataExecute executes the request
-	 */
+	// TestJsonFormDataExecute executes the request
 	TestJsonFormDataExecute(r ApiTestJsonFormDataRequest) (*_nethttp.Response, error)
 
 	/*
-	 * TestQueryParameterCollectionFormat Method for TestQueryParameterCollectionFormat
-	 * To test the collection format in query parameters
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiTestQueryParameterCollectionFormatRequest
+	TestQueryParameterCollectionFormat Method for TestQueryParameterCollectionFormat
+
+	To test the collection format in query parameters
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiTestQueryParameterCollectionFormatRequest
 	*/
 	TestQueryParameterCollectionFormat(ctx _context.Context) ApiTestQueryParameterCollectionFormatRequest
 
-	/*
-	 * TestQueryParameterCollectionFormatExecute executes the request
-	 */
+	// TestQueryParameterCollectionFormatExecute executes the request
 	TestQueryParameterCollectionFormatExecute(r ApiTestQueryParameterCollectionFormatRequest) (*_nethttp.Response, error)
 }
 
@@ -225,6 +222,7 @@ type ApiCreateXmlItemRequest struct {
 	xmlItem *XmlItem
 }
 
+// XmlItem Body
 func (r ApiCreateXmlItemRequest) XmlItem(xmlItem XmlItem) ApiCreateXmlItemRequest {
 	r.xmlItem = &xmlItem
 	return r
@@ -235,11 +233,13 @@ func (r ApiCreateXmlItemRequest) Execute() (*_nethttp.Response, error) {
 }
 
 /*
- * CreateXmlItem creates an XmlItem
- * this route creates an XmlItem
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiCreateXmlItemRequest
- */
+CreateXmlItem creates an XmlItem
+
+this route creates an XmlItem
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiCreateXmlItemRequest
+*/
 func (a *FakeApiService) CreateXmlItem(ctx _context.Context) ApiCreateXmlItemRequest {
 	return ApiCreateXmlItemRequest{
 		ApiService: a,
@@ -247,9 +247,7 @@ func (a *FakeApiService) CreateXmlItem(ctx _context.Context) ApiCreateXmlItemReq
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *FakeApiService) CreateXmlItemExecute(r ApiCreateXmlItemRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPost
@@ -326,6 +324,7 @@ type ApiFakeOuterBooleanSerializeRequest struct {
 	body *bool
 }
 
+// Input boolean as post body
 func (r ApiFakeOuterBooleanSerializeRequest) Body(body bool) ApiFakeOuterBooleanSerializeRequest {
 	r.body = &body
 	return r
@@ -336,11 +335,13 @@ func (r ApiFakeOuterBooleanSerializeRequest) Execute() (bool, *_nethttp.Response
 }
 
 /*
- * FakeOuterBooleanSerialize Method for FakeOuterBooleanSerialize
- * Test serialization of outer boolean types
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiFakeOuterBooleanSerializeRequest
- */
+FakeOuterBooleanSerialize Method for FakeOuterBooleanSerialize
+
+Test serialization of outer boolean types
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiFakeOuterBooleanSerializeRequest
+*/
 func (a *FakeApiService) FakeOuterBooleanSerialize(ctx _context.Context) ApiFakeOuterBooleanSerializeRequest {
 	return ApiFakeOuterBooleanSerializeRequest{
 		ApiService: a,
@@ -348,10 +349,8 @@ func (a *FakeApiService) FakeOuterBooleanSerialize(ctx _context.Context) ApiFake
 	}
 }
 
-/*
- * Execute executes the request
- * @return bool
- */
+// Execute executes the request
+//  @return bool
 func (a *FakeApiService) FakeOuterBooleanSerializeExecute(r ApiFakeOuterBooleanSerializeRequest) (bool, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPost
@@ -435,6 +434,7 @@ type ApiFakeOuterCompositeSerializeRequest struct {
 	body *OuterComposite
 }
 
+// Input composite as post body
 func (r ApiFakeOuterCompositeSerializeRequest) Body(body OuterComposite) ApiFakeOuterCompositeSerializeRequest {
 	r.body = &body
 	return r
@@ -445,11 +445,13 @@ func (r ApiFakeOuterCompositeSerializeRequest) Execute() (OuterComposite, *_neth
 }
 
 /*
- * FakeOuterCompositeSerialize Method for FakeOuterCompositeSerialize
- * Test serialization of object with outer number type
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiFakeOuterCompositeSerializeRequest
- */
+FakeOuterCompositeSerialize Method for FakeOuterCompositeSerialize
+
+Test serialization of object with outer number type
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiFakeOuterCompositeSerializeRequest
+*/
 func (a *FakeApiService) FakeOuterCompositeSerialize(ctx _context.Context) ApiFakeOuterCompositeSerializeRequest {
 	return ApiFakeOuterCompositeSerializeRequest{
 		ApiService: a,
@@ -457,10 +459,8 @@ func (a *FakeApiService) FakeOuterCompositeSerialize(ctx _context.Context) ApiFa
 	}
 }
 
-/*
- * Execute executes the request
- * @return OuterComposite
- */
+// Execute executes the request
+//  @return OuterComposite
 func (a *FakeApiService) FakeOuterCompositeSerializeExecute(r ApiFakeOuterCompositeSerializeRequest) (OuterComposite, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPost
@@ -544,6 +544,7 @@ type ApiFakeOuterNumberSerializeRequest struct {
 	body *float32
 }
 
+// Input number as post body
 func (r ApiFakeOuterNumberSerializeRequest) Body(body float32) ApiFakeOuterNumberSerializeRequest {
 	r.body = &body
 	return r
@@ -554,11 +555,13 @@ func (r ApiFakeOuterNumberSerializeRequest) Execute() (float32, *_nethttp.Respon
 }
 
 /*
- * FakeOuterNumberSerialize Method for FakeOuterNumberSerialize
- * Test serialization of outer number types
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiFakeOuterNumberSerializeRequest
- */
+FakeOuterNumberSerialize Method for FakeOuterNumberSerialize
+
+Test serialization of outer number types
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiFakeOuterNumberSerializeRequest
+*/
 func (a *FakeApiService) FakeOuterNumberSerialize(ctx _context.Context) ApiFakeOuterNumberSerializeRequest {
 	return ApiFakeOuterNumberSerializeRequest{
 		ApiService: a,
@@ -566,10 +569,8 @@ func (a *FakeApiService) FakeOuterNumberSerialize(ctx _context.Context) ApiFakeO
 	}
 }
 
-/*
- * Execute executes the request
- * @return float32
- */
+// Execute executes the request
+//  @return float32
 func (a *FakeApiService) FakeOuterNumberSerializeExecute(r ApiFakeOuterNumberSerializeRequest) (float32, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPost
@@ -653,6 +654,7 @@ type ApiFakeOuterStringSerializeRequest struct {
 	body *string
 }
 
+// Input string as post body
 func (r ApiFakeOuterStringSerializeRequest) Body(body string) ApiFakeOuterStringSerializeRequest {
 	r.body = &body
 	return r
@@ -663,11 +665,13 @@ func (r ApiFakeOuterStringSerializeRequest) Execute() (string, *_nethttp.Respons
 }
 
 /*
- * FakeOuterStringSerialize Method for FakeOuterStringSerialize
- * Test serialization of outer string types
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiFakeOuterStringSerializeRequest
- */
+FakeOuterStringSerialize Method for FakeOuterStringSerialize
+
+Test serialization of outer string types
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiFakeOuterStringSerializeRequest
+*/
 func (a *FakeApiService) FakeOuterStringSerialize(ctx _context.Context) ApiFakeOuterStringSerializeRequest {
 	return ApiFakeOuterStringSerializeRequest{
 		ApiService: a,
@@ -675,10 +679,8 @@ func (a *FakeApiService) FakeOuterStringSerialize(ctx _context.Context) ApiFakeO
 	}
 }
 
-/*
- * Execute executes the request
- * @return string
- */
+// Execute executes the request
+//  @return string
 func (a *FakeApiService) FakeOuterStringSerializeExecute(r ApiFakeOuterStringSerializeRequest) (string, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPost
@@ -772,11 +774,13 @@ func (r ApiTestBodyWithFileSchemaRequest) Execute() (*_nethttp.Response, error)
 }
 
 /*
- * TestBodyWithFileSchema Method for TestBodyWithFileSchema
- * For this test, the body for this request much reference a schema named `File`.
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiTestBodyWithFileSchemaRequest
- */
+TestBodyWithFileSchema Method for TestBodyWithFileSchema
+
+For this test, the body for this request much reference a schema named `File`.
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiTestBodyWithFileSchemaRequest
+*/
 func (a *FakeApiService) TestBodyWithFileSchema(ctx _context.Context) ApiTestBodyWithFileSchemaRequest {
 	return ApiTestBodyWithFileSchemaRequest{
 		ApiService: a,
@@ -784,9 +788,7 @@ func (a *FakeApiService) TestBodyWithFileSchema(ctx _context.Context) ApiTestBod
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *FakeApiService) TestBodyWithFileSchemaExecute(r ApiTestBodyWithFileSchemaRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPut
@@ -878,10 +880,11 @@ func (r ApiTestBodyWithQueryParamsRequest) Execute() (*_nethttp.Response, error)
 }
 
 /*
- * TestBodyWithQueryParams Method for TestBodyWithQueryParams
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiTestBodyWithQueryParamsRequest
- */
+TestBodyWithQueryParams Method for TestBodyWithQueryParams
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiTestBodyWithQueryParamsRequest
+*/
 func (a *FakeApiService) TestBodyWithQueryParams(ctx _context.Context) ApiTestBodyWithQueryParamsRequest {
 	return ApiTestBodyWithQueryParamsRequest{
 		ApiService: a,
@@ -889,9 +892,7 @@ func (a *FakeApiService) TestBodyWithQueryParams(ctx _context.Context) ApiTestBo
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *FakeApiService) TestBodyWithQueryParamsExecute(r ApiTestBodyWithQueryParamsRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPut
@@ -972,6 +973,7 @@ type ApiTestClientModelRequest struct {
 	body *Client
 }
 
+// client model
 func (r ApiTestClientModelRequest) Body(body Client) ApiTestClientModelRequest {
 	r.body = &body
 	return r
@@ -982,11 +984,13 @@ func (r ApiTestClientModelRequest) Execute() (Client, *_nethttp.Response, error)
 }
 
 /*
- * TestClientModel To test \"client\" model
- * To test "client" model
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiTestClientModelRequest
- */
+TestClientModel To test \"client\" model
+
+To test "client" model
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiTestClientModelRequest
+*/
 func (a *FakeApiService) TestClientModel(ctx _context.Context) ApiTestClientModelRequest {
 	return ApiTestClientModelRequest{
 		ApiService: a,
@@ -994,10 +998,8 @@ func (a *FakeApiService) TestClientModel(ctx _context.Context) ApiTestClientMode
 	}
 }
 
-/*
- * Execute executes the request
- * @return Client
- */
+// Execute executes the request
+//  @return Client
 func (a *FakeApiService) TestClientModelExecute(r ApiTestClientModelRequest) (Client, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPatch
@@ -1097,58 +1099,72 @@ type ApiTestEndpointParametersRequest struct {
 	callback *string
 }
 
+// None
 func (r ApiTestEndpointParametersRequest) Number(number float32) ApiTestEndpointParametersRequest {
 	r.number = &number
 	return r
 }
+// None
 func (r ApiTestEndpointParametersRequest) Double(double float64) ApiTestEndpointParametersRequest {
 	r.double = &double
 	return r
 }
+// None
 func (r ApiTestEndpointParametersRequest) PatternWithoutDelimiter(patternWithoutDelimiter string) ApiTestEndpointParametersRequest {
 	r.patternWithoutDelimiter = &patternWithoutDelimiter
 	return r
 }
+// None
 func (r ApiTestEndpointParametersRequest) Byte_(byte_ string) ApiTestEndpointParametersRequest {
 	r.byte_ = &byte_
 	return r
 }
+// None
 func (r ApiTestEndpointParametersRequest) Integer(integer int32) ApiTestEndpointParametersRequest {
 	r.integer = &integer
 	return r
 }
+// None
 func (r ApiTestEndpointParametersRequest) Int32_(int32_ int32) ApiTestEndpointParametersRequest {
 	r.int32_ = &int32_
 	return r
 }
+// None
 func (r ApiTestEndpointParametersRequest) Int64_(int64_ int64) ApiTestEndpointParametersRequest {
 	r.int64_ = &int64_
 	return r
 }
+// None
 func (r ApiTestEndpointParametersRequest) Float(float float32) ApiTestEndpointParametersRequest {
 	r.float = &float
 	return r
 }
+// None
 func (r ApiTestEndpointParametersRequest) String_(string_ string) ApiTestEndpointParametersRequest {
 	r.string_ = &string_
 	return r
 }
+// None
 func (r ApiTestEndpointParametersRequest) Binary(binary *os.File) ApiTestEndpointParametersRequest {
 	r.binary = &binary
 	return r
 }
+// None
 func (r ApiTestEndpointParametersRequest) Date(date string) ApiTestEndpointParametersRequest {
 	r.date = &date
 	return r
 }
+// None
 func (r ApiTestEndpointParametersRequest) DateTime(dateTime time.Time) ApiTestEndpointParametersRequest {
 	r.dateTime = &dateTime
 	return r
 }
+// None
 func (r ApiTestEndpointParametersRequest) Password(password string) ApiTestEndpointParametersRequest {
 	r.password = &password
 	return r
 }
+// None
 func (r ApiTestEndpointParametersRequest) Callback(callback string) ApiTestEndpointParametersRequest {
 	r.callback = &callback
 	return r
@@ -1159,14 +1175,16 @@ func (r ApiTestEndpointParametersRequest) Execute() (*_nethttp.Response, error)
 }
 
 /*
- * TestEndpointParameters Fake endpoint for testing various parameters  假端點  偽のエンドポイント  가짜 엔드 포인트
- * Fake endpoint for testing various parameters
+TestEndpointParameters Fake endpoint for testing various parameters  假端點  偽のエンドポイント  가짜 엔드 포인트
+
+Fake endpoint for testing various parameters
  假端點
  偽のエンドポイント
  가짜 엔드 포인트
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiTestEndpointParametersRequest
- */
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiTestEndpointParametersRequest
+*/
 func (a *FakeApiService) TestEndpointParameters(ctx _context.Context) ApiTestEndpointParametersRequest {
 	return ApiTestEndpointParametersRequest{
 		ApiService: a,
@@ -1174,9 +1192,7 @@ func (a *FakeApiService) TestEndpointParameters(ctx _context.Context) ApiTestEnd
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *FakeApiService) TestEndpointParametersExecute(r ApiTestEndpointParametersRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPost
@@ -1321,34 +1337,42 @@ type ApiTestEnumParametersRequest struct {
 	enumFormString *string
 }
 
+// Header parameter enum test (string array)
 func (r ApiTestEnumParametersRequest) EnumHeaderStringArray(enumHeaderStringArray []string) ApiTestEnumParametersRequest {
 	r.enumHeaderStringArray = &enumHeaderStringArray
 	return r
 }
+// Header parameter enum test (string)
 func (r ApiTestEnumParametersRequest) EnumHeaderString(enumHeaderString string) ApiTestEnumParametersRequest {
 	r.enumHeaderString = &enumHeaderString
 	return r
 }
+// Query parameter enum test (string array)
 func (r ApiTestEnumParametersRequest) EnumQueryStringArray(enumQueryStringArray []string) ApiTestEnumParametersRequest {
 	r.enumQueryStringArray = &enumQueryStringArray
 	return r
 }
+// Query parameter enum test (string)
 func (r ApiTestEnumParametersRequest) EnumQueryString(enumQueryString string) ApiTestEnumParametersRequest {
 	r.enumQueryString = &enumQueryString
 	return r
 }
+// Query parameter enum test (double)
 func (r ApiTestEnumParametersRequest) EnumQueryInteger(enumQueryInteger int32) ApiTestEnumParametersRequest {
 	r.enumQueryInteger = &enumQueryInteger
 	return r
 }
+// Query parameter enum test (double)
 func (r ApiTestEnumParametersRequest) EnumQueryDouble(enumQueryDouble float64) ApiTestEnumParametersRequest {
 	r.enumQueryDouble = &enumQueryDouble
 	return r
 }
+// Form parameter enum test (string array)
 func (r ApiTestEnumParametersRequest) EnumFormStringArray(enumFormStringArray []string) ApiTestEnumParametersRequest {
 	r.enumFormStringArray = &enumFormStringArray
 	return r
 }
+// Form parameter enum test (string)
 func (r ApiTestEnumParametersRequest) EnumFormString(enumFormString string) ApiTestEnumParametersRequest {
 	r.enumFormString = &enumFormString
 	return r
@@ -1359,11 +1383,13 @@ func (r ApiTestEnumParametersRequest) Execute() (*_nethttp.Response, error) {
 }
 
 /*
- * TestEnumParameters To test enum parameters
- * To test enum parameters
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiTestEnumParametersRequest
- */
+TestEnumParameters To test enum parameters
+
+To test enum parameters
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiTestEnumParametersRequest
+*/
 func (a *FakeApiService) TestEnumParameters(ctx _context.Context) ApiTestEnumParametersRequest {
 	return ApiTestEnumParametersRequest{
 		ApiService: a,
@@ -1371,9 +1397,7 @@ func (a *FakeApiService) TestEnumParameters(ctx _context.Context) ApiTestEnumPar
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *FakeApiService) TestEnumParametersExecute(r ApiTestEnumParametersRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodGet
@@ -1474,26 +1498,32 @@ type ApiTestGroupParametersRequest struct {
 	int64Group *int64
 }
 
+// Required String in group parameters
 func (r ApiTestGroupParametersRequest) RequiredStringGroup(requiredStringGroup int32) ApiTestGroupParametersRequest {
 	r.requiredStringGroup = &requiredStringGroup
 	return r
 }
+// Required Boolean in group parameters
 func (r ApiTestGroupParametersRequest) RequiredBooleanGroup(requiredBooleanGroup bool) ApiTestGroupParametersRequest {
 	r.requiredBooleanGroup = &requiredBooleanGroup
 	return r
 }
+// Required Integer in group parameters
 func (r ApiTestGroupParametersRequest) RequiredInt64Group(requiredInt64Group int64) ApiTestGroupParametersRequest {
 	r.requiredInt64Group = &requiredInt64Group
 	return r
 }
+// String in group parameters
 func (r ApiTestGroupParametersRequest) StringGroup(stringGroup int32) ApiTestGroupParametersRequest {
 	r.stringGroup = &stringGroup
 	return r
 }
+// Boolean in group parameters
 func (r ApiTestGroupParametersRequest) BooleanGroup(booleanGroup bool) ApiTestGroupParametersRequest {
 	r.booleanGroup = &booleanGroup
 	return r
 }
+// Integer in group parameters
 func (r ApiTestGroupParametersRequest) Int64Group(int64Group int64) ApiTestGroupParametersRequest {
 	r.int64Group = &int64Group
 	return r
@@ -1504,11 +1534,13 @@ func (r ApiTestGroupParametersRequest) Execute() (*_nethttp.Response, error) {
 }
 
 /*
- * TestGroupParameters Fake endpoint to test group parameters (optional)
- * Fake endpoint to test group parameters (optional)
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiTestGroupParametersRequest
- */
+TestGroupParameters Fake endpoint to test group parameters (optional)
+
+Fake endpoint to test group parameters (optional)
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiTestGroupParametersRequest
+*/
 func (a *FakeApiService) TestGroupParameters(ctx _context.Context) ApiTestGroupParametersRequest {
 	return ApiTestGroupParametersRequest{
 		ApiService: a,
@@ -1516,9 +1548,7 @@ func (a *FakeApiService) TestGroupParameters(ctx _context.Context) ApiTestGroupP
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *FakeApiService) TestGroupParametersExecute(r ApiTestGroupParametersRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodDelete
@@ -1611,6 +1641,7 @@ type ApiTestInlineAdditionalPropertiesRequest struct {
 	param *map[string]string
 }
 
+// request body
 func (r ApiTestInlineAdditionalPropertiesRequest) Param(param map[string]string) ApiTestInlineAdditionalPropertiesRequest {
 	r.param = &param
 	return r
@@ -1621,10 +1652,11 @@ func (r ApiTestInlineAdditionalPropertiesRequest) Execute() (*_nethttp.Response,
 }
 
 /*
- * TestInlineAdditionalProperties test inline additionalProperties
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiTestInlineAdditionalPropertiesRequest
- */
+TestInlineAdditionalProperties test inline additionalProperties
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiTestInlineAdditionalPropertiesRequest
+*/
 func (a *FakeApiService) TestInlineAdditionalProperties(ctx _context.Context) ApiTestInlineAdditionalPropertiesRequest {
 	return ApiTestInlineAdditionalPropertiesRequest{
 		ApiService: a,
@@ -1632,9 +1664,7 @@ func (a *FakeApiService) TestInlineAdditionalProperties(ctx _context.Context) Ap
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *FakeApiService) TestInlineAdditionalPropertiesExecute(r ApiTestInlineAdditionalPropertiesRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPost
@@ -1712,10 +1742,12 @@ type ApiTestJsonFormDataRequest struct {
 	param2 *string
 }
 
+// field1
 func (r ApiTestJsonFormDataRequest) Param(param string) ApiTestJsonFormDataRequest {
 	r.param = &param
 	return r
 }
+// field2
 func (r ApiTestJsonFormDataRequest) Param2(param2 string) ApiTestJsonFormDataRequest {
 	r.param2 = &param2
 	return r
@@ -1726,10 +1758,11 @@ func (r ApiTestJsonFormDataRequest) Execute() (*_nethttp.Response, error) {
 }
 
 /*
- * TestJsonFormData test json serialization of form data
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiTestJsonFormDataRequest
- */
+TestJsonFormData test json serialization of form data
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiTestJsonFormDataRequest
+*/
 func (a *FakeApiService) TestJsonFormData(ctx _context.Context) ApiTestJsonFormDataRequest {
 	return ApiTestJsonFormDataRequest{
 		ApiService: a,
@@ -1737,9 +1770,7 @@ func (a *FakeApiService) TestJsonFormData(ctx _context.Context) ApiTestJsonFormD
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *FakeApiService) TestJsonFormDataExecute(r ApiTestJsonFormDataRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodGet
@@ -1849,11 +1880,13 @@ func (r ApiTestQueryParameterCollectionFormatRequest) Execute() (*_nethttp.Respo
 }
 
 /*
- * TestQueryParameterCollectionFormat Method for TestQueryParameterCollectionFormat
- * To test the collection format in query parameters
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiTestQueryParameterCollectionFormatRequest
- */
+TestQueryParameterCollectionFormat Method for TestQueryParameterCollectionFormat
+
+To test the collection format in query parameters
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiTestQueryParameterCollectionFormatRequest
+*/
 func (a *FakeApiService) TestQueryParameterCollectionFormat(ctx _context.Context) ApiTestQueryParameterCollectionFormatRequest {
 	return ApiTestQueryParameterCollectionFormatRequest{
 		ApiService: a,
@@ -1861,9 +1894,7 @@ func (a *FakeApiService) TestQueryParameterCollectionFormat(ctx _context.Context
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *FakeApiService) TestQueryParameterCollectionFormatExecute(r ApiTestQueryParameterCollectionFormatRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPut

samples/client/petstore/go/go-petstore/api_fake_classname_tags123.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 
@@ -26,17 +26,17 @@ var (
 type FakeClassnameTags123Api interface {
 
 	/*
-	 * TestClassname To test class name in snake case
-	 * To test class name in snake case
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiTestClassnameRequest
+	TestClassname To test class name in snake case
+
+	To test class name in snake case
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiTestClassnameRequest
 	*/
 	TestClassname(ctx _context.Context) ApiTestClassnameRequest
 
-	/*
-	 * TestClassnameExecute executes the request
-	 * @return Client
-	 */
+	// TestClassnameExecute executes the request
+	//  @return Client
 	TestClassnameExecute(r ApiTestClassnameRequest) (Client, *_nethttp.Response, error)
 }
 
@@ -49,6 +49,7 @@ type ApiTestClassnameRequest struct {
 	body *Client
 }
 
+// client model
 func (r ApiTestClassnameRequest) Body(body Client) ApiTestClassnameRequest {
 	r.body = &body
 	return r
@@ -59,11 +60,13 @@ func (r ApiTestClassnameRequest) Execute() (Client, *_nethttp.Response, error) {
 }
 
 /*
- * TestClassname To test class name in snake case
- * To test class name in snake case
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiTestClassnameRequest
- */
+TestClassname To test class name in snake case
+
+To test class name in snake case
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiTestClassnameRequest
+*/
 func (a *FakeClassnameTags123ApiService) TestClassname(ctx _context.Context) ApiTestClassnameRequest {
 	return ApiTestClassnameRequest{
 		ApiService: a,
@@ -71,10 +74,8 @@ func (a *FakeClassnameTags123ApiService) TestClassname(ctx _context.Context) Api
 	}
 }
 
-/*
- * Execute executes the request
- * @return Client
- */
+// Execute executes the request
+//  @return Client
 func (a *FakeClassnameTags123ApiService) TestClassnameExecute(r ApiTestClassnameRequest) (Client, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPatch

samples/client/petstore/go/go-petstore/api_pet.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 
@@ -28,124 +28,121 @@ var (
 type PetApi interface {
 
 	/*
-	 * AddPet Add a new pet to the store
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiAddPetRequest
+	AddPet Add a new pet to the store
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiAddPetRequest
 	*/
 	AddPet(ctx _context.Context) ApiAddPetRequest
 
-	/*
-	 * AddPetExecute executes the request
-	 */
+	// AddPetExecute executes the request
 	AddPetExecute(r ApiAddPetRequest) (*_nethttp.Response, error)
 
 	/*
-	 * DeletePet Deletes a pet
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @param petId Pet id to delete
-	 * @return ApiDeletePetRequest
+	DeletePet Deletes a pet
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @param petId Pet id to delete
+	 @return ApiDeletePetRequest
 	*/
 	DeletePet(ctx _context.Context, petId int64) ApiDeletePetRequest
 
-	/*
-	 * DeletePetExecute executes the request
-	 */
+	// DeletePetExecute executes the request
 	DeletePetExecute(r ApiDeletePetRequest) (*_nethttp.Response, error)
 
 	/*
-	 * FindPetsByStatus Finds Pets by status
-	 * Multiple status values can be provided with comma separated strings
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiFindPetsByStatusRequest
+	FindPetsByStatus Finds Pets by status
+
+	Multiple status values can be provided with comma separated strings
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiFindPetsByStatusRequest
 	*/
 	FindPetsByStatus(ctx _context.Context) ApiFindPetsByStatusRequest
 
-	/*
-	 * FindPetsByStatusExecute executes the request
-	 * @return []Pet
-	 */
+	// FindPetsByStatusExecute executes the request
+	//  @return []Pet
 	FindPetsByStatusExecute(r ApiFindPetsByStatusRequest) ([]Pet, *_nethttp.Response, error)
 
 	/*
-	 * FindPetsByTags Finds Pets by tags
-	 * Multiple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiFindPetsByTagsRequest
+	FindPetsByTags Finds Pets by tags
+
+	Multiple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiFindPetsByTagsRequest
+
+	Deprecated
 	*/
 	FindPetsByTags(ctx _context.Context) ApiFindPetsByTagsRequest
 
-	/*
-	 * FindPetsByTagsExecute executes the request
-	 * @return []Pet
-	 */
+	// FindPetsByTagsExecute executes the request
+	//  @return []Pet
+	// Deprecated
 	FindPetsByTagsExecute(r ApiFindPetsByTagsRequest) ([]Pet, *_nethttp.Response, error)
 
 	/*
-	 * GetPetById Find pet by ID
-	 * Returns a single pet
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @param petId ID of pet to return
-	 * @return ApiGetPetByIdRequest
+	GetPetById Find pet by ID
+
+	Returns a single pet
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @param petId ID of pet to return
+	 @return ApiGetPetByIdRequest
 	*/
 	GetPetById(ctx _context.Context, petId int64) ApiGetPetByIdRequest
 
-	/*
-	 * GetPetByIdExecute executes the request
-	 * @return Pet
-	 */
+	// GetPetByIdExecute executes the request
+	//  @return Pet
 	GetPetByIdExecute(r ApiGetPetByIdRequest) (Pet, *_nethttp.Response, error)
 
 	/*
-	 * UpdatePet Update an existing pet
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiUpdatePetRequest
+	UpdatePet Update an existing pet
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiUpdatePetRequest
 	*/
 	UpdatePet(ctx _context.Context) ApiUpdatePetRequest
 
-	/*
-	 * UpdatePetExecute executes the request
-	 */
+	// UpdatePetExecute executes the request
 	UpdatePetExecute(r ApiUpdatePetRequest) (*_nethttp.Response, error)
 
 	/*
-	 * UpdatePetWithForm Updates a pet in the store with form data
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @param petId ID of pet that needs to be updated
-	 * @return ApiUpdatePetWithFormRequest
+	UpdatePetWithForm Updates a pet in the store with form data
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @param petId ID of pet that needs to be updated
+	 @return ApiUpdatePetWithFormRequest
 	*/
 	UpdatePetWithForm(ctx _context.Context, petId int64) ApiUpdatePetWithFormRequest
 
-	/*
-	 * UpdatePetWithFormExecute executes the request
-	 */
+	// UpdatePetWithFormExecute executes the request
 	UpdatePetWithFormExecute(r ApiUpdatePetWithFormRequest) (*_nethttp.Response, error)
 
 	/*
-	 * UploadFile uploads an image
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @param petId ID of pet to update
-	 * @return ApiUploadFileRequest
+	UploadFile uploads an image
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @param petId ID of pet to update
+	 @return ApiUploadFileRequest
 	*/
 	UploadFile(ctx _context.Context, petId int64) ApiUploadFileRequest
 
-	/*
-	 * UploadFileExecute executes the request
-	 * @return ApiResponse
-	 */
+	// UploadFileExecute executes the request
+	//  @return ApiResponse
 	UploadFileExecute(r ApiUploadFileRequest) (ApiResponse, *_nethttp.Response, error)
 
 	/*
-	 * UploadFileWithRequiredFile uploads an image (required)
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @param petId ID of pet to update
-	 * @return ApiUploadFileWithRequiredFileRequest
+	UploadFileWithRequiredFile uploads an image (required)
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @param petId ID of pet to update
+	 @return ApiUploadFileWithRequiredFileRequest
 	*/
 	UploadFileWithRequiredFile(ctx _context.Context, petId int64) ApiUploadFileWithRequiredFileRequest
 
-	/*
-	 * UploadFileWithRequiredFileExecute executes the request
-	 * @return ApiResponse
-	 */
+	// UploadFileWithRequiredFileExecute executes the request
+	//  @return ApiResponse
 	UploadFileWithRequiredFileExecute(r ApiUploadFileWithRequiredFileRequest) (ApiResponse, *_nethttp.Response, error)
 }
 
@@ -158,6 +155,7 @@ type ApiAddPetRequest struct {
 	body *Pet
 }
 
+// Pet object that needs to be added to the store
 func (r ApiAddPetRequest) Body(body Pet) ApiAddPetRequest {
 	r.body = &body
 	return r
@@ -168,10 +166,11 @@ func (r ApiAddPetRequest) Execute() (*_nethttp.Response, error) {
 }
 
 /*
- * AddPet Add a new pet to the store
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiAddPetRequest
- */
+AddPet Add a new pet to the store
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiAddPetRequest
+*/
 func (a *PetApiService) AddPet(ctx _context.Context) ApiAddPetRequest {
 	return ApiAddPetRequest{
 		ApiService: a,
@@ -179,9 +178,7 @@ func (a *PetApiService) AddPet(ctx _context.Context) ApiAddPetRequest {
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *PetApiService) AddPetExecute(r ApiAddPetRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPost
@@ -269,11 +266,12 @@ func (r ApiDeletePetRequest) Execute() (*_nethttp.Response, error) {
 }
 
 /*
- * DeletePet Deletes a pet
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @param petId Pet id to delete
- * @return ApiDeletePetRequest
- */
+DeletePet Deletes a pet
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @param petId Pet id to delete
+ @return ApiDeletePetRequest
+*/
 func (a *PetApiService) DeletePet(ctx _context.Context, petId int64) ApiDeletePetRequest {
 	return ApiDeletePetRequest{
 		ApiService: a,
@@ -282,9 +280,7 @@ func (a *PetApiService) DeletePet(ctx _context.Context, petId int64) ApiDeletePe
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *PetApiService) DeletePetExecute(r ApiDeletePetRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodDelete
@@ -360,6 +356,7 @@ type ApiFindPetsByStatusRequest struct {
 	status *[]string
 }
 
+// Status values that need to be considered for filter
 func (r ApiFindPetsByStatusRequest) Status(status []string) ApiFindPetsByStatusRequest {
 	r.status = &status
 	return r
@@ -370,11 +367,13 @@ func (r ApiFindPetsByStatusRequest) Execute() ([]Pet, *_nethttp.Response, error)
 }
 
 /*
- * FindPetsByStatus Finds Pets by status
- * Multiple status values can be provided with comma separated strings
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiFindPetsByStatusRequest
- */
+FindPetsByStatus Finds Pets by status
+
+Multiple status values can be provided with comma separated strings
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiFindPetsByStatusRequest
+*/
 func (a *PetApiService) FindPetsByStatus(ctx _context.Context) ApiFindPetsByStatusRequest {
 	return ApiFindPetsByStatusRequest{
 		ApiService: a,
@@ -382,10 +381,8 @@ func (a *PetApiService) FindPetsByStatus(ctx _context.Context) ApiFindPetsByStat
 	}
 }
 
-/*
- * Execute executes the request
- * @return []Pet
- */
+// Execute executes the request
+//  @return []Pet
 func (a *PetApiService) FindPetsByStatusExecute(r ApiFindPetsByStatusRequest) ([]Pet, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodGet
@@ -471,6 +468,7 @@ type ApiFindPetsByTagsRequest struct {
 	tags *[]string
 }
 
+// Tags to filter by
 func (r ApiFindPetsByTagsRequest) Tags(tags []string) ApiFindPetsByTagsRequest {
 	r.tags = &tags
 	return r
@@ -481,11 +479,15 @@ func (r ApiFindPetsByTagsRequest) Execute() ([]Pet, *_nethttp.Response, error) {
 }
 
 /*
- * FindPetsByTags Finds Pets by tags
- * Multiple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiFindPetsByTagsRequest
- */
+FindPetsByTags Finds Pets by tags
+
+Multiple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiFindPetsByTagsRequest
+
+Deprecated
+*/
 func (a *PetApiService) FindPetsByTags(ctx _context.Context) ApiFindPetsByTagsRequest {
 	return ApiFindPetsByTagsRequest{
 		ApiService: a,
@@ -493,10 +495,9 @@ func (a *PetApiService) FindPetsByTags(ctx _context.Context) ApiFindPetsByTagsRe
 	}
 }
 
-/*
- * Execute executes the request
- * @return []Pet
- */
+// Execute executes the request
+//  @return []Pet
+// Deprecated
 func (a *PetApiService) FindPetsByTagsExecute(r ApiFindPetsByTagsRequest) ([]Pet, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodGet
@@ -588,12 +589,14 @@ func (r ApiGetPetByIdRequest) Execute() (Pet, *_nethttp.Response, error) {
 }
 
 /*
- * GetPetById Find pet by ID
- * Returns a single pet
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @param petId ID of pet to return
- * @return ApiGetPetByIdRequest
- */
+GetPetById Find pet by ID
+
+Returns a single pet
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @param petId ID of pet to return
+ @return ApiGetPetByIdRequest
+*/
 func (a *PetApiService) GetPetById(ctx _context.Context, petId int64) ApiGetPetByIdRequest {
 	return ApiGetPetByIdRequest{
 		ApiService: a,
@@ -602,10 +605,8 @@ func (a *PetApiService) GetPetById(ctx _context.Context, petId int64) ApiGetPetB
 	}
 }
 
-/*
- * Execute executes the request
- * @return Pet
- */
+// Execute executes the request
+//  @return Pet
 func (a *PetApiService) GetPetByIdExecute(r ApiGetPetByIdRequest) (Pet, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodGet
@@ -702,6 +703,7 @@ type ApiUpdatePetRequest struct {
 	body *Pet
 }
 
+// Pet object that needs to be added to the store
 func (r ApiUpdatePetRequest) Body(body Pet) ApiUpdatePetRequest {
 	r.body = &body
 	return r
@@ -712,10 +714,11 @@ func (r ApiUpdatePetRequest) Execute() (*_nethttp.Response, error) {
 }
 
 /*
- * UpdatePet Update an existing pet
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiUpdatePetRequest
- */
+UpdatePet Update an existing pet
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiUpdatePetRequest
+*/
 func (a *PetApiService) UpdatePet(ctx _context.Context) ApiUpdatePetRequest {
 	return ApiUpdatePetRequest{
 		ApiService: a,
@@ -723,9 +726,7 @@ func (a *PetApiService) UpdatePet(ctx _context.Context) ApiUpdatePetRequest {
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *PetApiService) UpdatePetExecute(r ApiUpdatePetRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPut
@@ -804,10 +805,12 @@ type ApiUpdatePetWithFormRequest struct {
 	status *string
 }
 
+// Updated name of the pet
 func (r ApiUpdatePetWithFormRequest) Name(name string) ApiUpdatePetWithFormRequest {
 	r.name = &name
 	return r
 }
+// Updated status of the pet
 func (r ApiUpdatePetWithFormRequest) Status(status string) ApiUpdatePetWithFormRequest {
 	r.status = &status
 	return r
@@ -818,11 +821,12 @@ func (r ApiUpdatePetWithFormRequest) Execute() (*_nethttp.Response, error) {
 }
 
 /*
- * UpdatePetWithForm Updates a pet in the store with form data
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @param petId ID of pet that needs to be updated
- * @return ApiUpdatePetWithFormRequest
- */
+UpdatePetWithForm Updates a pet in the store with form data
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @param petId ID of pet that needs to be updated
+ @return ApiUpdatePetWithFormRequest
+*/
 func (a *PetApiService) UpdatePetWithForm(ctx _context.Context, petId int64) ApiUpdatePetWithFormRequest {
 	return ApiUpdatePetWithFormRequest{
 		ApiService: a,
@@ -831,9 +835,7 @@ func (a *PetApiService) UpdatePetWithForm(ctx _context.Context, petId int64) Api
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *PetApiService) UpdatePetWithFormExecute(r ApiUpdatePetWithFormRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPost
@@ -914,10 +916,12 @@ type ApiUploadFileRequest struct {
 	file **os.File
 }
 
+// Additional data to pass to server
 func (r ApiUploadFileRequest) AdditionalMetadata(additionalMetadata string) ApiUploadFileRequest {
 	r.additionalMetadata = &additionalMetadata
 	return r
 }
+// file to upload
 func (r ApiUploadFileRequest) File(file *os.File) ApiUploadFileRequest {
 	r.file = &file
 	return r
@@ -928,11 +932,12 @@ func (r ApiUploadFileRequest) Execute() (ApiResponse, *_nethttp.Response, error)
 }
 
 /*
- * UploadFile uploads an image
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @param petId ID of pet to update
- * @return ApiUploadFileRequest
- */
+UploadFile uploads an image
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @param petId ID of pet to update
+ @return ApiUploadFileRequest
+*/
 func (a *PetApiService) UploadFile(ctx _context.Context, petId int64) ApiUploadFileRequest {
 	return ApiUploadFileRequest{
 		ApiService: a,
@@ -941,10 +946,8 @@ func (a *PetApiService) UploadFile(ctx _context.Context, petId int64) ApiUploadF
 	}
 }
 
-/*
- * Execute executes the request
- * @return ApiResponse
- */
+// Execute executes the request
+//  @return ApiResponse
 func (a *PetApiService) UploadFileExecute(r ApiUploadFileRequest) (ApiResponse, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPost
@@ -1043,10 +1046,12 @@ type ApiUploadFileWithRequiredFileRequest struct {
 	additionalMetadata *string
 }
 
+// file to upload
 func (r ApiUploadFileWithRequiredFileRequest) RequiredFile(requiredFile *os.File) ApiUploadFileWithRequiredFileRequest {
 	r.requiredFile = &requiredFile
 	return r
 }
+// Additional data to pass to server
 func (r ApiUploadFileWithRequiredFileRequest) AdditionalMetadata(additionalMetadata string) ApiUploadFileWithRequiredFileRequest {
 	r.additionalMetadata = &additionalMetadata
 	return r
@@ -1057,11 +1062,12 @@ func (r ApiUploadFileWithRequiredFileRequest) Execute() (ApiResponse, *_nethttp.
 }
 
 /*
- * UploadFileWithRequiredFile uploads an image (required)
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @param petId ID of pet to update
- * @return ApiUploadFileWithRequiredFileRequest
- */
+UploadFileWithRequiredFile uploads an image (required)
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @param petId ID of pet to update
+ @return ApiUploadFileWithRequiredFileRequest
+*/
 func (a *PetApiService) UploadFileWithRequiredFile(ctx _context.Context, petId int64) ApiUploadFileWithRequiredFileRequest {
 	return ApiUploadFileWithRequiredFileRequest{
 		ApiService: a,
@@ -1070,10 +1076,8 @@ func (a *PetApiService) UploadFileWithRequiredFile(ctx _context.Context, petId i
 	}
 }
 
-/*
- * Execute executes the request
- * @return ApiResponse
- */
+// Execute executes the request
+//  @return ApiResponse
 func (a *PetApiService) UploadFileWithRequiredFileExecute(r ApiUploadFileWithRequiredFileRequest) (ApiResponse, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPost

samples/client/petstore/go/go-petstore/api_store.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 
@@ -27,59 +27,58 @@ var (
 type StoreApi interface {
 
 	/*
-	 * DeleteOrder Delete purchase order by ID
-	 * For valid response try integer IDs with value < 1000. Anything above 1000 or nonintegers will generate API errors
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @param orderId ID of the order that needs to be deleted
-	 * @return ApiDeleteOrderRequest
+	DeleteOrder Delete purchase order by ID
+
+	For valid response try integer IDs with value < 1000. Anything above 1000 or nonintegers will generate API errors
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @param orderId ID of the order that needs to be deleted
+	 @return ApiDeleteOrderRequest
 	*/
 	DeleteOrder(ctx _context.Context, orderId string) ApiDeleteOrderRequest
 
-	/*
-	 * DeleteOrderExecute executes the request
-	 */
+	// DeleteOrderExecute executes the request
 	DeleteOrderExecute(r ApiDeleteOrderRequest) (*_nethttp.Response, error)
 
 	/*
-	 * GetInventory Returns pet inventories by status
-	 * Returns a map of status codes to quantities
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiGetInventoryRequest
+	GetInventory Returns pet inventories by status
+
+	Returns a map of status codes to quantities
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiGetInventoryRequest
 	*/
 	GetInventory(ctx _context.Context) ApiGetInventoryRequest
 
-	/*
-	 * GetInventoryExecute executes the request
-	 * @return map[string]int32
-	 */
+	// GetInventoryExecute executes the request
+	//  @return map[string]int32
 	GetInventoryExecute(r ApiGetInventoryRequest) (map[string]int32, *_nethttp.Response, error)
 
 	/*
-	 * GetOrderById Find purchase order by ID
-	 * For valid response try integer IDs with value <= 5 or > 10. Other values will generated exceptions
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @param orderId ID of pet that needs to be fetched
-	 * @return ApiGetOrderByIdRequest
+	GetOrderById Find purchase order by ID
+
+	For valid response try integer IDs with value <= 5 or > 10. Other values will generated exceptions
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @param orderId ID of pet that needs to be fetched
+	 @return ApiGetOrderByIdRequest
 	*/
 	GetOrderById(ctx _context.Context, orderId int64) ApiGetOrderByIdRequest
 
-	/*
-	 * GetOrderByIdExecute executes the request
-	 * @return Order
-	 */
+	// GetOrderByIdExecute executes the request
+	//  @return Order
 	GetOrderByIdExecute(r ApiGetOrderByIdRequest) (Order, *_nethttp.Response, error)
 
 	/*
-	 * PlaceOrder Place an order for a pet
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiPlaceOrderRequest
+	PlaceOrder Place an order for a pet
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiPlaceOrderRequest
 	*/
 	PlaceOrder(ctx _context.Context) ApiPlaceOrderRequest
 
-	/*
-	 * PlaceOrderExecute executes the request
-	 * @return Order
-	 */
+	// PlaceOrderExecute executes the request
+	//  @return Order
 	PlaceOrderExecute(r ApiPlaceOrderRequest) (Order, *_nethttp.Response, error)
 }
 
@@ -98,12 +97,14 @@ func (r ApiDeleteOrderRequest) Execute() (*_nethttp.Response, error) {
 }
 
 /*
- * DeleteOrder Delete purchase order by ID
- * For valid response try integer IDs with value < 1000. Anything above 1000 or nonintegers will generate API errors
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @param orderId ID of the order that needs to be deleted
- * @return ApiDeleteOrderRequest
- */
+DeleteOrder Delete purchase order by ID
+
+For valid response try integer IDs with value < 1000. Anything above 1000 or nonintegers will generate API errors
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @param orderId ID of the order that needs to be deleted
+ @return ApiDeleteOrderRequest
+*/
 func (a *StoreApiService) DeleteOrder(ctx _context.Context, orderId string) ApiDeleteOrderRequest {
 	return ApiDeleteOrderRequest{
 		ApiService: a,
@@ -112,9 +113,7 @@ func (a *StoreApiService) DeleteOrder(ctx _context.Context, orderId string) ApiD
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *StoreApiService) DeleteOrderExecute(r ApiDeleteOrderRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodDelete
@@ -192,11 +191,13 @@ func (r ApiGetInventoryRequest) Execute() (map[string]int32, *_nethttp.Response,
 }
 
 /*
- * GetInventory Returns pet inventories by status
- * Returns a map of status codes to quantities
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiGetInventoryRequest
- */
+GetInventory Returns pet inventories by status
+
+Returns a map of status codes to quantities
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiGetInventoryRequest
+*/
 func (a *StoreApiService) GetInventory(ctx _context.Context) ApiGetInventoryRequest {
 	return ApiGetInventoryRequest{
 		ApiService: a,
@@ -204,10 +205,8 @@ func (a *StoreApiService) GetInventory(ctx _context.Context) ApiGetInventoryRequ
 	}
 }
 
-/*
- * Execute executes the request
- * @return map[string]int32
- */
+// Execute executes the request
+//  @return map[string]int32
 func (a *StoreApiService) GetInventoryExecute(r ApiGetInventoryRequest) (map[string]int32, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodGet
@@ -309,12 +308,14 @@ func (r ApiGetOrderByIdRequest) Execute() (Order, *_nethttp.Response, error) {
 }
 
 /*
- * GetOrderById Find purchase order by ID
- * For valid response try integer IDs with value <= 5 or > 10. Other values will generated exceptions
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @param orderId ID of pet that needs to be fetched
- * @return ApiGetOrderByIdRequest
- */
+GetOrderById Find purchase order by ID
+
+For valid response try integer IDs with value <= 5 or > 10. Other values will generated exceptions
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @param orderId ID of pet that needs to be fetched
+ @return ApiGetOrderByIdRequest
+*/
 func (a *StoreApiService) GetOrderById(ctx _context.Context, orderId int64) ApiGetOrderByIdRequest {
 	return ApiGetOrderByIdRequest{
 		ApiService: a,
@@ -323,10 +324,8 @@ func (a *StoreApiService) GetOrderById(ctx _context.Context, orderId int64) ApiG
 	}
 }
 
-/*
- * Execute executes the request
- * @return Order
- */
+// Execute executes the request
+//  @return Order
 func (a *StoreApiService) GetOrderByIdExecute(r ApiGetOrderByIdRequest) (Order, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodGet
@@ -415,6 +414,7 @@ type ApiPlaceOrderRequest struct {
 	body *Order
 }
 
+// order placed for purchasing the pet
 func (r ApiPlaceOrderRequest) Body(body Order) ApiPlaceOrderRequest {
 	r.body = &body
 	return r
@@ -425,10 +425,11 @@ func (r ApiPlaceOrderRequest) Execute() (Order, *_nethttp.Response, error) {
 }
 
 /*
- * PlaceOrder Place an order for a pet
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiPlaceOrderRequest
- */
+PlaceOrder Place an order for a pet
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiPlaceOrderRequest
+*/
 func (a *StoreApiService) PlaceOrder(ctx _context.Context) ApiPlaceOrderRequest {
 	return ApiPlaceOrderRequest{
 		ApiService: a,
@@ -436,10 +437,8 @@ func (a *StoreApiService) PlaceOrder(ctx _context.Context) ApiPlaceOrderRequest
 	}
 }
 
-/*
- * Execute executes the request
- * @return Order
- */
+// Execute executes the request
+//  @return Order
 func (a *StoreApiService) PlaceOrderExecute(r ApiPlaceOrderRequest) (Order, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPost

samples/client/petstore/go/go-petstore/api_user.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 
@@ -27,107 +27,102 @@ var (
 type UserApi interface {
 
 	/*
-	 * CreateUser Create user
-	 * This can only be done by the logged in user.
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiCreateUserRequest
+	CreateUser Create user
+
+	This can only be done by the logged in user.
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiCreateUserRequest
 	*/
 	CreateUser(ctx _context.Context) ApiCreateUserRequest
 
-	/*
-	 * CreateUserExecute executes the request
-	 */
+	// CreateUserExecute executes the request
 	CreateUserExecute(r ApiCreateUserRequest) (*_nethttp.Response, error)
 
 	/*
-	 * CreateUsersWithArrayInput Creates list of users with given input array
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiCreateUsersWithArrayInputRequest
+	CreateUsersWithArrayInput Creates list of users with given input array
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiCreateUsersWithArrayInputRequest
 	*/
 	CreateUsersWithArrayInput(ctx _context.Context) ApiCreateUsersWithArrayInputRequest
 
-	/*
-	 * CreateUsersWithArrayInputExecute executes the request
-	 */
+	// CreateUsersWithArrayInputExecute executes the request
 	CreateUsersWithArrayInputExecute(r ApiCreateUsersWithArrayInputRequest) (*_nethttp.Response, error)
 
 	/*
-	 * CreateUsersWithListInput Creates list of users with given input array
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiCreateUsersWithListInputRequest
+	CreateUsersWithListInput Creates list of users with given input array
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiCreateUsersWithListInputRequest
 	*/
 	CreateUsersWithListInput(ctx _context.Context) ApiCreateUsersWithListInputRequest
 
-	/*
-	 * CreateUsersWithListInputExecute executes the request
-	 */
+	// CreateUsersWithListInputExecute executes the request
 	CreateUsersWithListInputExecute(r ApiCreateUsersWithListInputRequest) (*_nethttp.Response, error)
 
 	/*
-	 * DeleteUser Delete user
-	 * This can only be done by the logged in user.
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @param username The name that needs to be deleted
-	 * @return ApiDeleteUserRequest
+	DeleteUser Delete user
+
+	This can only be done by the logged in user.
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @param username The name that needs to be deleted
+	 @return ApiDeleteUserRequest
 	*/
 	DeleteUser(ctx _context.Context, username string) ApiDeleteUserRequest
 
-	/*
-	 * DeleteUserExecute executes the request
-	 */
+	// DeleteUserExecute executes the request
 	DeleteUserExecute(r ApiDeleteUserRequest) (*_nethttp.Response, error)
 
 	/*
-	 * GetUserByName Get user by user name
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @param username The name that needs to be fetched. Use user1 for testing.
-	 * @return ApiGetUserByNameRequest
+	GetUserByName Get user by user name
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @param username The name that needs to be fetched. Use user1 for testing.
+	 @return ApiGetUserByNameRequest
 	*/
 	GetUserByName(ctx _context.Context, username string) ApiGetUserByNameRequest
 
-	/*
-	 * GetUserByNameExecute executes the request
-	 * @return User
-	 */
+	// GetUserByNameExecute executes the request
+	//  @return User
 	GetUserByNameExecute(r ApiGetUserByNameRequest) (User, *_nethttp.Response, error)
 
 	/*
-	 * LoginUser Logs user into the system
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiLoginUserRequest
+	LoginUser Logs user into the system
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiLoginUserRequest
 	*/
 	LoginUser(ctx _context.Context) ApiLoginUserRequest
 
-	/*
-	 * LoginUserExecute executes the request
-	 * @return string
-	 */
+	// LoginUserExecute executes the request
+	//  @return string
 	LoginUserExecute(r ApiLoginUserRequest) (string, *_nethttp.Response, error)
 
 	/*
-	 * LogoutUser Logs out current logged in user session
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiLogoutUserRequest
+	LogoutUser Logs out current logged in user session
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiLogoutUserRequest
 	*/
 	LogoutUser(ctx _context.Context) ApiLogoutUserRequest
 
-	/*
-	 * LogoutUserExecute executes the request
-	 */
+	// LogoutUserExecute executes the request
 	LogoutUserExecute(r ApiLogoutUserRequest) (*_nethttp.Response, error)
 
 	/*
-	 * UpdateUser Updated user
-	 * This can only be done by the logged in user.
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @param username name that need to be deleted
-	 * @return ApiUpdateUserRequest
+	UpdateUser Updated user
+
+	This can only be done by the logged in user.
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @param username name that need to be deleted
+	 @return ApiUpdateUserRequest
 	*/
 	UpdateUser(ctx _context.Context, username string) ApiUpdateUserRequest
 
-	/*
-	 * UpdateUserExecute executes the request
-	 */
+	// UpdateUserExecute executes the request
 	UpdateUserExecute(r ApiUpdateUserRequest) (*_nethttp.Response, error)
 }
 
@@ -140,6 +135,7 @@ type ApiCreateUserRequest struct {
 	body *User
 }
 
+// Created user object
 func (r ApiCreateUserRequest) Body(body User) ApiCreateUserRequest {
 	r.body = &body
 	return r
@@ -150,11 +146,13 @@ func (r ApiCreateUserRequest) Execute() (*_nethttp.Response, error) {
 }
 
 /*
- * CreateUser Create user
- * This can only be done by the logged in user.
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiCreateUserRequest
- */
+CreateUser Create user
+
+This can only be done by the logged in user.
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiCreateUserRequest
+*/
 func (a *UserApiService) CreateUser(ctx _context.Context) ApiCreateUserRequest {
 	return ApiCreateUserRequest{
 		ApiService: a,
@@ -162,9 +160,7 @@ func (a *UserApiService) CreateUser(ctx _context.Context) ApiCreateUserRequest {
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *UserApiService) CreateUserExecute(r ApiCreateUserRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPost
@@ -241,6 +237,7 @@ type ApiCreateUsersWithArrayInputRequest struct {
 	body *[]User
 }
 
+// List of user object
 func (r ApiCreateUsersWithArrayInputRequest) Body(body []User) ApiCreateUsersWithArrayInputRequest {
 	r.body = &body
 	return r
@@ -251,10 +248,11 @@ func (r ApiCreateUsersWithArrayInputRequest) Execute() (*_nethttp.Response, erro
 }
 
 /*
- * CreateUsersWithArrayInput Creates list of users with given input array
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiCreateUsersWithArrayInputRequest
- */
+CreateUsersWithArrayInput Creates list of users with given input array
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiCreateUsersWithArrayInputRequest
+*/
 func (a *UserApiService) CreateUsersWithArrayInput(ctx _context.Context) ApiCreateUsersWithArrayInputRequest {
 	return ApiCreateUsersWithArrayInputRequest{
 		ApiService: a,
@@ -262,9 +260,7 @@ func (a *UserApiService) CreateUsersWithArrayInput(ctx _context.Context) ApiCrea
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *UserApiService) CreateUsersWithArrayInputExecute(r ApiCreateUsersWithArrayInputRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPost
@@ -341,6 +337,7 @@ type ApiCreateUsersWithListInputRequest struct {
 	body *[]User
 }
 
+// List of user object
 func (r ApiCreateUsersWithListInputRequest) Body(body []User) ApiCreateUsersWithListInputRequest {
 	r.body = &body
 	return r
@@ -351,10 +348,11 @@ func (r ApiCreateUsersWithListInputRequest) Execute() (*_nethttp.Response, error
 }
 
 /*
- * CreateUsersWithListInput Creates list of users with given input array
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiCreateUsersWithListInputRequest
- */
+CreateUsersWithListInput Creates list of users with given input array
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiCreateUsersWithListInputRequest
+*/
 func (a *UserApiService) CreateUsersWithListInput(ctx _context.Context) ApiCreateUsersWithListInputRequest {
 	return ApiCreateUsersWithListInputRequest{
 		ApiService: a,
@@ -362,9 +360,7 @@ func (a *UserApiService) CreateUsersWithListInput(ctx _context.Context) ApiCreat
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *UserApiService) CreateUsersWithListInputExecute(r ApiCreateUsersWithListInputRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPost
@@ -447,12 +443,14 @@ func (r ApiDeleteUserRequest) Execute() (*_nethttp.Response, error) {
 }
 
 /*
- * DeleteUser Delete user
- * This can only be done by the logged in user.
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @param username The name that needs to be deleted
- * @return ApiDeleteUserRequest
- */
+DeleteUser Delete user
+
+This can only be done by the logged in user.
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @param username The name that needs to be deleted
+ @return ApiDeleteUserRequest
+*/
 func (a *UserApiService) DeleteUser(ctx _context.Context, username string) ApiDeleteUserRequest {
 	return ApiDeleteUserRequest{
 		ApiService: a,
@@ -461,9 +459,7 @@ func (a *UserApiService) DeleteUser(ctx _context.Context, username string) ApiDe
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *UserApiService) DeleteUserExecute(r ApiDeleteUserRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodDelete
@@ -542,11 +538,12 @@ func (r ApiGetUserByNameRequest) Execute() (User, *_nethttp.Response, error) {
 }
 
 /*
- * GetUserByName Get user by user name
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @param username The name that needs to be fetched. Use user1 for testing.
- * @return ApiGetUserByNameRequest
- */
+GetUserByName Get user by user name
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @param username The name that needs to be fetched. Use user1 for testing.
+ @return ApiGetUserByNameRequest
+*/
 func (a *UserApiService) GetUserByName(ctx _context.Context, username string) ApiGetUserByNameRequest {
 	return ApiGetUserByNameRequest{
 		ApiService: a,
@@ -555,10 +552,8 @@ func (a *UserApiService) GetUserByName(ctx _context.Context, username string) Ap
 	}
 }
 
-/*
- * Execute executes the request
- * @return User
- */
+// Execute executes the request
+//  @return User
 func (a *UserApiService) GetUserByNameExecute(r ApiGetUserByNameRequest) (User, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodGet
@@ -642,10 +637,12 @@ type ApiLoginUserRequest struct {
 	password *string
 }
 
+// The user name for login
 func (r ApiLoginUserRequest) Username(username string) ApiLoginUserRequest {
 	r.username = &username
 	return r
 }
+// The password for login in clear text
 func (r ApiLoginUserRequest) Password(password string) ApiLoginUserRequest {
 	r.password = &password
 	return r
@@ -656,10 +653,11 @@ func (r ApiLoginUserRequest) Execute() (string, *_nethttp.Response, error) {
 }
 
 /*
- * LoginUser Logs user into the system
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiLoginUserRequest
- */
+LoginUser Logs user into the system
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiLoginUserRequest
+*/
 func (a *UserApiService) LoginUser(ctx _context.Context) ApiLoginUserRequest {
 	return ApiLoginUserRequest{
 		ApiService: a,
@@ -667,10 +665,8 @@ func (a *UserApiService) LoginUser(ctx _context.Context) ApiLoginUserRequest {
 	}
 }
 
-/*
- * Execute executes the request
- * @return string
- */
+// Execute executes the request
+//  @return string
 func (a *UserApiService) LoginUserExecute(r ApiLoginUserRequest) (string, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodGet
@@ -765,10 +761,11 @@ func (r ApiLogoutUserRequest) Execute() (*_nethttp.Response, error) {
 }
 
 /*
- * LogoutUser Logs out current logged in user session
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiLogoutUserRequest
- */
+LogoutUser Logs out current logged in user session
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiLogoutUserRequest
+*/
 func (a *UserApiService) LogoutUser(ctx _context.Context) ApiLogoutUserRequest {
 	return ApiLogoutUserRequest{
 		ApiService: a,
@@ -776,9 +773,7 @@ func (a *UserApiService) LogoutUser(ctx _context.Context) ApiLogoutUserRequest {
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *UserApiService) LogoutUserExecute(r ApiLogoutUserRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodGet
@@ -851,6 +846,7 @@ type ApiUpdateUserRequest struct {
 	body *User
 }
 
+// Updated user object
 func (r ApiUpdateUserRequest) Body(body User) ApiUpdateUserRequest {
 	r.body = &body
 	return r
@@ -861,12 +857,14 @@ func (r ApiUpdateUserRequest) Execute() (*_nethttp.Response, error) {
 }
 
 /*
- * UpdateUser Updated user
- * This can only be done by the logged in user.
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @param username name that need to be deleted
- * @return ApiUpdateUserRequest
- */
+UpdateUser Updated user
+
+This can only be done by the logged in user.
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @param username name that need to be deleted
+ @return ApiUpdateUserRequest
+*/
 func (a *UserApiService) UpdateUser(ctx _context.Context, username string) ApiUpdateUserRequest {
 	return ApiUpdateUserRequest{
 		ApiService: a,
@@ -875,9 +873,7 @@ func (a *UserApiService) UpdateUser(ctx _context.Context, username string) ApiUp
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *UserApiService) UpdateUserExecute(r ApiUpdateUserRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPut

samples/client/petstore/go/go-petstore/client.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/configuration.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_200_response.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_additional_properties_any_type.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_additional_properties_array.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_additional_properties_boolean.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_additional_properties_class.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_additional_properties_integer.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_additional_properties_number.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_additional_properties_object.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_additional_properties_string.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_animal.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_api_response.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_array_of_array_of_number_only.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_array_of_number_only.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_array_test_.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_big_cat.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_big_cat_all_of.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_capitalization.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_cat.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_cat_all_of.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_category.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_class_model.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_client.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_dog.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_dog_all_of.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_enum_arrays.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_enum_class.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_enum_test_.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_file.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_file_schema_test_class.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_format_test_.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_has_only_read_only.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_list.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_map_test_.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_mixed_properties_and_additional_properties_class.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_name.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_number_only.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_order.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_outer_composite.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_outer_enum.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_pet.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_read_only_first.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_return.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_special_model_name.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_tag.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_type_holder_default.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_type_holder_example.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_user.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/model_xml_item.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/response.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/go/go-petstore/utils.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/client/petstore/typescript-axios/builds/with-fake-endpoints-models-for-testing-with-http-signature/api.ts

@@ -1101,6 +1101,7 @@ export interface Pet {
      * pet status in the store
      * @type {string}
      * @memberof Pet
+     * @deprecated
      */
     status?: PetStatusEnum;
 }

samples/openapi3/client/extensions/x-auth-id-alias/go-experimental/api_usage.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Extension x-auth-id-alias
- *
- * This specification shows how to use x-auth-id-alias extension for API keys.
- *
- * API version: 1.0.0
- */
+OpenAPI Extension x-auth-id-alias
+
+This specification shows how to use x-auth-id-alias extension for API keys.
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 
@@ -37,11 +37,13 @@ func (r ApiAnyKeyRequest) Execute() (map[string]interface{}, *_nethttp.Response,
 }
 
 /*
- * AnyKey Use any API key
- * Use any API key
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiAnyKeyRequest
- */
+AnyKey Use any API key
+
+Use any API key
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiAnyKeyRequest
+*/
 func (a *UsageApiService) AnyKey(ctx _context.Context) ApiAnyKeyRequest {
 	return ApiAnyKeyRequest{
 		ApiService: a,
@@ -49,10 +51,8 @@ func (a *UsageApiService) AnyKey(ctx _context.Context) ApiAnyKeyRequest {
 	}
 }
 
-/*
- * Execute executes the request
- * @return map[string]interface{}
- */
+// Execute executes the request
+//  @return map[string]interface{}
 func (a *UsageApiService) AnyKeyExecute(r ApiAnyKeyRequest) (map[string]interface{}, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodGet
@@ -167,11 +167,13 @@ func (r ApiBothKeysRequest) Execute() (map[string]interface{}, *_nethttp.Respons
 }
 
 /*
- * BothKeys Use both API keys
- * Use both API keys
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiBothKeysRequest
- */
+BothKeys Use both API keys
+
+Use both API keys
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiBothKeysRequest
+*/
 func (a *UsageApiService) BothKeys(ctx _context.Context) ApiBothKeysRequest {
 	return ApiBothKeysRequest{
 		ApiService: a,
@@ -179,10 +181,8 @@ func (a *UsageApiService) BothKeys(ctx _context.Context) ApiBothKeysRequest {
 	}
 }
 
-/*
- * Execute executes the request
- * @return map[string]interface{}
- */
+// Execute executes the request
+//  @return map[string]interface{}
 func (a *UsageApiService) BothKeysExecute(r ApiBothKeysRequest) (map[string]interface{}, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodGet
@@ -297,11 +297,13 @@ func (r ApiKeyInHeaderRequest) Execute() (map[string]interface{}, *_nethttp.Resp
 }
 
 /*
- * KeyInHeader Use API key in header
- * Use API key in header
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiKeyInHeaderRequest
- */
+KeyInHeader Use API key in header
+
+Use API key in header
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiKeyInHeaderRequest
+*/
 func (a *UsageApiService) KeyInHeader(ctx _context.Context) ApiKeyInHeaderRequest {
 	return ApiKeyInHeaderRequest{
 		ApiService: a,
@@ -309,10 +311,8 @@ func (a *UsageApiService) KeyInHeader(ctx _context.Context) ApiKeyInHeaderReques
 	}
 }
 
-/*
- * Execute executes the request
- * @return map[string]interface{}
- */
+// Execute executes the request
+//  @return map[string]interface{}
 func (a *UsageApiService) KeyInHeaderExecute(r ApiKeyInHeaderRequest) (map[string]interface{}, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodGet
@@ -413,11 +413,13 @@ func (r ApiKeyInQueryRequest) Execute() (map[string]interface{}, *_nethttp.Respo
 }
 
 /*
- * KeyInQuery Use API key in query
- * Use API key in query
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiKeyInQueryRequest
- */
+KeyInQuery Use API key in query
+
+Use API key in query
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiKeyInQueryRequest
+*/
 func (a *UsageApiService) KeyInQuery(ctx _context.Context) ApiKeyInQueryRequest {
 	return ApiKeyInQueryRequest{
 		ApiService: a,
@@ -425,10 +427,8 @@ func (a *UsageApiService) KeyInQuery(ctx _context.Context) ApiKeyInQueryRequest
 	}
 }
 
-/*
- * Execute executes the request
- * @return map[string]interface{}
- */
+// Execute executes the request
+//  @return map[string]interface{}
 func (a *UsageApiService) KeyInQueryExecute(r ApiKeyInQueryRequest) (map[string]interface{}, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodGet

samples/openapi3/client/extensions/x-auth-id-alias/go-experimental/client.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Extension x-auth-id-alias
- *
- * This specification shows how to use x-auth-id-alias extension for API keys.
- *
- * API version: 1.0.0
- */
+OpenAPI Extension x-auth-id-alias
+
+This specification shows how to use x-auth-id-alias extension for API keys.
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/openapi3/client/extensions/x-auth-id-alias/go-experimental/configuration.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Extension x-auth-id-alias
- *
- * This specification shows how to use x-auth-id-alias extension for API keys.
- *
- * API version: 1.0.0
- */
+OpenAPI Extension x-auth-id-alias
+
+This specification shows how to use x-auth-id-alias extension for API keys.
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/openapi3/client/extensions/x-auth-id-alias/go-experimental/response.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Extension x-auth-id-alias
- *
- * This specification shows how to use x-auth-id-alias extension for API keys.
- *
- * API version: 1.0.0
- */
+OpenAPI Extension x-auth-id-alias
+
+This specification shows how to use x-auth-id-alias extension for API keys.
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/openapi3/client/extensions/x-auth-id-alias/go-experimental/utils.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Extension x-auth-id-alias
- *
- * This specification shows how to use x-auth-id-alias extension for API keys.
- *
- * API version: 1.0.0
- */
+OpenAPI Extension x-auth-id-alias
+
+This specification shows how to use x-auth-id-alias extension for API keys.
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/openapi3/client/petstore/go/go-petstore/api/openapi.yaml

@@ -93,7 +93,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
@@ -1440,6 +1441,7 @@ components:
             name: tag
             wrapped: true
         status:
+          deprecated: true
           description: pet status in the store
           enum:
           - available

samples/openapi3/client/petstore/go/go-petstore/api_another_fake.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 
@@ -26,17 +26,17 @@ var (
 type AnotherFakeApi interface {
 
 	/*
-	 * Call123TestSpecialTags To test special tags
-	 * To test special tags and operation ID starting with number
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiCall123TestSpecialTagsRequest
+	Call123TestSpecialTags To test special tags
+
+	To test special tags and operation ID starting with number
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiCall123TestSpecialTagsRequest
 	*/
 	Call123TestSpecialTags(ctx _context.Context) ApiCall123TestSpecialTagsRequest
 
-	/*
-	 * Call123TestSpecialTagsExecute executes the request
-	 * @return Client
-	 */
+	// Call123TestSpecialTagsExecute executes the request
+	//  @return Client
 	Call123TestSpecialTagsExecute(r ApiCall123TestSpecialTagsRequest) (Client, *_nethttp.Response, error)
 }
 
@@ -49,6 +49,7 @@ type ApiCall123TestSpecialTagsRequest struct {
 	client *Client
 }
 
+// client model
 func (r ApiCall123TestSpecialTagsRequest) Client(client Client) ApiCall123TestSpecialTagsRequest {
 	r.client = &client
 	return r
@@ -59,11 +60,13 @@ func (r ApiCall123TestSpecialTagsRequest) Execute() (Client, *_nethttp.Response,
 }
 
 /*
- * Call123TestSpecialTags To test special tags
- * To test special tags and operation ID starting with number
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiCall123TestSpecialTagsRequest
- */
+Call123TestSpecialTags To test special tags
+
+To test special tags and operation ID starting with number
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiCall123TestSpecialTagsRequest
+*/
 func (a *AnotherFakeApiService) Call123TestSpecialTags(ctx _context.Context) ApiCall123TestSpecialTagsRequest {
 	return ApiCall123TestSpecialTagsRequest{
 		ApiService: a,
@@ -71,10 +74,8 @@ func (a *AnotherFakeApiService) Call123TestSpecialTags(ctx _context.Context) Api
 	}
 }
 
-/*
- * Execute executes the request
- * @return Client
- */
+// Execute executes the request
+//  @return Client
 func (a *AnotherFakeApiService) Call123TestSpecialTagsExecute(r ApiCall123TestSpecialTagsRequest) (Client, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPatch

samples/openapi3/client/petstore/go/go-petstore/api_default.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 
@@ -26,16 +26,15 @@ var (
 type DefaultApi interface {
 
 	/*
-	 * FooGet Method for FooGet
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiFooGetRequest
+	FooGet Method for FooGet
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiFooGetRequest
 	*/
 	FooGet(ctx _context.Context) ApiFooGetRequest
 
-	/*
-	 * FooGetExecute executes the request
-	 * @return InlineResponseDefault
-	 */
+	// FooGetExecute executes the request
+	//  @return InlineResponseDefault
 	FooGetExecute(r ApiFooGetRequest) (InlineResponseDefault, *_nethttp.Response, error)
 }
 
@@ -53,10 +52,11 @@ func (r ApiFooGetRequest) Execute() (InlineResponseDefault, *_nethttp.Response,
 }
 
 /*
- * FooGet Method for FooGet
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiFooGetRequest
- */
+FooGet Method for FooGet
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiFooGetRequest
+*/
 func (a *DefaultApiService) FooGet(ctx _context.Context) ApiFooGetRequest {
 	return ApiFooGetRequest{
 		ApiService: a,
@@ -64,10 +64,8 @@ func (a *DefaultApiService) FooGet(ctx _context.Context) ApiFooGetRequest {
 	}
 }
 
-/*
- * Execute executes the request
- * @return InlineResponseDefault
- */
+// Execute executes the request
+//  @return InlineResponseDefault
 func (a *DefaultApiService) FooGetExecute(r ApiFooGetRequest) (InlineResponseDefault, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodGet

samples/openapi3/client/petstore/go/go-petstore/api_fake.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 
@@ -29,205 +29,201 @@ var (
 type FakeApi interface {
 
 	/*
-	 * FakeHealthGet Health check endpoint
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiFakeHealthGetRequest
+	FakeHealthGet Health check endpoint
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiFakeHealthGetRequest
 	*/
 	FakeHealthGet(ctx _context.Context) ApiFakeHealthGetRequest
 
-	/*
-	 * FakeHealthGetExecute executes the request
-	 * @return HealthCheckResult
-	 */
+	// FakeHealthGetExecute executes the request
+	//  @return HealthCheckResult
 	FakeHealthGetExecute(r ApiFakeHealthGetRequest) (HealthCheckResult, *_nethttp.Response, error)
 
 	/*
-	 * FakeOuterBooleanSerialize Method for FakeOuterBooleanSerialize
-	 * Test serialization of outer boolean types
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiFakeOuterBooleanSerializeRequest
+	FakeOuterBooleanSerialize Method for FakeOuterBooleanSerialize
+
+	Test serialization of outer boolean types
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiFakeOuterBooleanSerializeRequest
 	*/
 	FakeOuterBooleanSerialize(ctx _context.Context) ApiFakeOuterBooleanSerializeRequest
 
-	/*
-	 * FakeOuterBooleanSerializeExecute executes the request
-	 * @return bool
-	 */
+	// FakeOuterBooleanSerializeExecute executes the request
+	//  @return bool
 	FakeOuterBooleanSerializeExecute(r ApiFakeOuterBooleanSerializeRequest) (bool, *_nethttp.Response, error)
 
 	/*
-	 * FakeOuterCompositeSerialize Method for FakeOuterCompositeSerialize
-	 * Test serialization of object with outer number type
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiFakeOuterCompositeSerializeRequest
+	FakeOuterCompositeSerialize Method for FakeOuterCompositeSerialize
+
+	Test serialization of object with outer number type
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiFakeOuterCompositeSerializeRequest
 	*/
 	FakeOuterCompositeSerialize(ctx _context.Context) ApiFakeOuterCompositeSerializeRequest
 
-	/*
-	 * FakeOuterCompositeSerializeExecute executes the request
-	 * @return OuterComposite
-	 */
+	// FakeOuterCompositeSerializeExecute executes the request
+	//  @return OuterComposite
 	FakeOuterCompositeSerializeExecute(r ApiFakeOuterCompositeSerializeRequest) (OuterComposite, *_nethttp.Response, error)
 
 	/*
-	 * FakeOuterNumberSerialize Method for FakeOuterNumberSerialize
-	 * Test serialization of outer number types
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiFakeOuterNumberSerializeRequest
+	FakeOuterNumberSerialize Method for FakeOuterNumberSerialize
+
+	Test serialization of outer number types
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiFakeOuterNumberSerializeRequest
 	*/
 	FakeOuterNumberSerialize(ctx _context.Context) ApiFakeOuterNumberSerializeRequest
 
-	/*
-	 * FakeOuterNumberSerializeExecute executes the request
-	 * @return float32
-	 */
+	// FakeOuterNumberSerializeExecute executes the request
+	//  @return float32
 	FakeOuterNumberSerializeExecute(r ApiFakeOuterNumberSerializeRequest) (float32, *_nethttp.Response, error)
 
 	/*
-	 * FakeOuterStringSerialize Method for FakeOuterStringSerialize
-	 * Test serialization of outer string types
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiFakeOuterStringSerializeRequest
+	FakeOuterStringSerialize Method for FakeOuterStringSerialize
+
+	Test serialization of outer string types
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiFakeOuterStringSerializeRequest
 	*/
 	FakeOuterStringSerialize(ctx _context.Context) ApiFakeOuterStringSerializeRequest
 
-	/*
-	 * FakeOuterStringSerializeExecute executes the request
-	 * @return string
-	 */
+	// FakeOuterStringSerializeExecute executes the request
+	//  @return string
 	FakeOuterStringSerializeExecute(r ApiFakeOuterStringSerializeRequest) (string, *_nethttp.Response, error)
 
 	/*
-	 * TestBodyWithFileSchema Method for TestBodyWithFileSchema
-	 * For this test, the body for this request much reference a schema named `File`.
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiTestBodyWithFileSchemaRequest
+	TestBodyWithFileSchema Method for TestBodyWithFileSchema
+
+	For this test, the body for this request much reference a schema named `File`.
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiTestBodyWithFileSchemaRequest
 	*/
 	TestBodyWithFileSchema(ctx _context.Context) ApiTestBodyWithFileSchemaRequest
 
-	/*
-	 * TestBodyWithFileSchemaExecute executes the request
-	 */
+	// TestBodyWithFileSchemaExecute executes the request
 	TestBodyWithFileSchemaExecute(r ApiTestBodyWithFileSchemaRequest) (*_nethttp.Response, error)
 
 	/*
-	 * TestBodyWithQueryParams Method for TestBodyWithQueryParams
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiTestBodyWithQueryParamsRequest
+	TestBodyWithQueryParams Method for TestBodyWithQueryParams
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiTestBodyWithQueryParamsRequest
 	*/
 	TestBodyWithQueryParams(ctx _context.Context) ApiTestBodyWithQueryParamsRequest
 
-	/*
-	 * TestBodyWithQueryParamsExecute executes the request
-	 */
+	// TestBodyWithQueryParamsExecute executes the request
 	TestBodyWithQueryParamsExecute(r ApiTestBodyWithQueryParamsRequest) (*_nethttp.Response, error)
 
 	/*
-	 * TestClientModel To test \"client\" model
-	 * To test "client" model
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiTestClientModelRequest
+	TestClientModel To test \"client\" model
+
+	To test "client" model
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiTestClientModelRequest
 	*/
 	TestClientModel(ctx _context.Context) ApiTestClientModelRequest
 
-	/*
-	 * TestClientModelExecute executes the request
-	 * @return Client
-	 */
+	// TestClientModelExecute executes the request
+	//  @return Client
 	TestClientModelExecute(r ApiTestClientModelRequest) (Client, *_nethttp.Response, error)
 
 	/*
-	 * TestEndpointParameters Fake endpoint for testing various parameters 假端點 偽のエンドポイント 가짜 엔드 포인트 
-	 * Fake endpoint for testing various parameters
+	TestEndpointParameters Fake endpoint for testing various parameters 假端點 偽のエンドポイント 가짜 엔드 포인트 
+
+	Fake endpoint for testing various parameters
 假端點
 偽のエンドポイント
 가짜 엔드 포인트
 
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiTestEndpointParametersRequest
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiTestEndpointParametersRequest
 	*/
 	TestEndpointParameters(ctx _context.Context) ApiTestEndpointParametersRequest
 
-	/*
-	 * TestEndpointParametersExecute executes the request
-	 */
+	// TestEndpointParametersExecute executes the request
 	TestEndpointParametersExecute(r ApiTestEndpointParametersRequest) (*_nethttp.Response, error)
 
 	/*
-	 * TestEnumParameters To test enum parameters
-	 * To test enum parameters
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiTestEnumParametersRequest
+	TestEnumParameters To test enum parameters
+
+	To test enum parameters
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiTestEnumParametersRequest
 	*/
 	TestEnumParameters(ctx _context.Context) ApiTestEnumParametersRequest
 
-	/*
-	 * TestEnumParametersExecute executes the request
-	 */
+	// TestEnumParametersExecute executes the request
 	TestEnumParametersExecute(r ApiTestEnumParametersRequest) (*_nethttp.Response, error)
 
 	/*
-	 * TestGroupParameters Fake endpoint to test group parameters (optional)
-	 * Fake endpoint to test group parameters (optional)
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiTestGroupParametersRequest
+	TestGroupParameters Fake endpoint to test group parameters (optional)
+
+	Fake endpoint to test group parameters (optional)
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiTestGroupParametersRequest
 	*/
 	TestGroupParameters(ctx _context.Context) ApiTestGroupParametersRequest
 
-	/*
-	 * TestGroupParametersExecute executes the request
-	 */
+	// TestGroupParametersExecute executes the request
 	TestGroupParametersExecute(r ApiTestGroupParametersRequest) (*_nethttp.Response, error)
 
 	/*
-	 * TestInlineAdditionalProperties test inline additionalProperties
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiTestInlineAdditionalPropertiesRequest
+	TestInlineAdditionalProperties test inline additionalProperties
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiTestInlineAdditionalPropertiesRequest
 	*/
 	TestInlineAdditionalProperties(ctx _context.Context) ApiTestInlineAdditionalPropertiesRequest
 
-	/*
-	 * TestInlineAdditionalPropertiesExecute executes the request
-	 */
+	// TestInlineAdditionalPropertiesExecute executes the request
 	TestInlineAdditionalPropertiesExecute(r ApiTestInlineAdditionalPropertiesRequest) (*_nethttp.Response, error)
 
 	/*
-	 * TestJsonFormData test json serialization of form data
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiTestJsonFormDataRequest
+	TestJsonFormData test json serialization of form data
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiTestJsonFormDataRequest
 	*/
 	TestJsonFormData(ctx _context.Context) ApiTestJsonFormDataRequest
 
-	/*
-	 * TestJsonFormDataExecute executes the request
-	 */
+	// TestJsonFormDataExecute executes the request
 	TestJsonFormDataExecute(r ApiTestJsonFormDataRequest) (*_nethttp.Response, error)
 
 	/*
-	 * TestQueryParameterCollectionFormat Method for TestQueryParameterCollectionFormat
-	 * To test the collection format in query parameters
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiTestQueryParameterCollectionFormatRequest
+	TestQueryParameterCollectionFormat Method for TestQueryParameterCollectionFormat
+
+	To test the collection format in query parameters
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiTestQueryParameterCollectionFormatRequest
 	*/
 	TestQueryParameterCollectionFormat(ctx _context.Context) ApiTestQueryParameterCollectionFormatRequest
 
-	/*
-	 * TestQueryParameterCollectionFormatExecute executes the request
-	 */
+	// TestQueryParameterCollectionFormatExecute executes the request
 	TestQueryParameterCollectionFormatExecute(r ApiTestQueryParameterCollectionFormatRequest) (*_nethttp.Response, error)
 
 	/*
-	 * TestUniqueItemsHeaderAndQueryParameterCollectionFormat Method for TestUniqueItemsHeaderAndQueryParameterCollectionFormat
-	 * To test unique items in header and query parameters
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiTestUniqueItemsHeaderAndQueryParameterCollectionFormatRequest
+	TestUniqueItemsHeaderAndQueryParameterCollectionFormat Method for TestUniqueItemsHeaderAndQueryParameterCollectionFormat
+
+	To test unique items in header and query parameters
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiTestUniqueItemsHeaderAndQueryParameterCollectionFormatRequest
 	*/
 	TestUniqueItemsHeaderAndQueryParameterCollectionFormat(ctx _context.Context) ApiTestUniqueItemsHeaderAndQueryParameterCollectionFormatRequest
 
-	/*
-	 * TestUniqueItemsHeaderAndQueryParameterCollectionFormatExecute executes the request
-	 * @return []Pet
-	 */
+	// TestUniqueItemsHeaderAndQueryParameterCollectionFormatExecute executes the request
+	//  @return []Pet
 	TestUniqueItemsHeaderAndQueryParameterCollectionFormatExecute(r ApiTestUniqueItemsHeaderAndQueryParameterCollectionFormatRequest) ([]Pet, *_nethttp.Response, error)
 }
 
@@ -245,10 +241,11 @@ func (r ApiFakeHealthGetRequest) Execute() (HealthCheckResult, *_nethttp.Respons
 }
 
 /*
- * FakeHealthGet Health check endpoint
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiFakeHealthGetRequest
- */
+FakeHealthGet Health check endpoint
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiFakeHealthGetRequest
+*/
 func (a *FakeApiService) FakeHealthGet(ctx _context.Context) ApiFakeHealthGetRequest {
 	return ApiFakeHealthGetRequest{
 		ApiService: a,
@@ -256,10 +253,8 @@ func (a *FakeApiService) FakeHealthGet(ctx _context.Context) ApiFakeHealthGetReq
 	}
 }
 
-/*
- * Execute executes the request
- * @return HealthCheckResult
- */
+// Execute executes the request
+//  @return HealthCheckResult
 func (a *FakeApiService) FakeHealthGetExecute(r ApiFakeHealthGetRequest) (HealthCheckResult, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodGet
@@ -341,6 +336,7 @@ type ApiFakeOuterBooleanSerializeRequest struct {
 	body *bool
 }
 
+// Input boolean as post body
 func (r ApiFakeOuterBooleanSerializeRequest) Body(body bool) ApiFakeOuterBooleanSerializeRequest {
 	r.body = &body
 	return r
@@ -351,11 +347,13 @@ func (r ApiFakeOuterBooleanSerializeRequest) Execute() (bool, *_nethttp.Response
 }
 
 /*
- * FakeOuterBooleanSerialize Method for FakeOuterBooleanSerialize
- * Test serialization of outer boolean types
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiFakeOuterBooleanSerializeRequest
- */
+FakeOuterBooleanSerialize Method for FakeOuterBooleanSerialize
+
+Test serialization of outer boolean types
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiFakeOuterBooleanSerializeRequest
+*/
 func (a *FakeApiService) FakeOuterBooleanSerialize(ctx _context.Context) ApiFakeOuterBooleanSerializeRequest {
 	return ApiFakeOuterBooleanSerializeRequest{
 		ApiService: a,
@@ -363,10 +361,8 @@ func (a *FakeApiService) FakeOuterBooleanSerialize(ctx _context.Context) ApiFake
 	}
 }
 
-/*
- * Execute executes the request
- * @return bool
- */
+// Execute executes the request
+//  @return bool
 func (a *FakeApiService) FakeOuterBooleanSerializeExecute(r ApiFakeOuterBooleanSerializeRequest) (bool, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPost
@@ -450,6 +446,7 @@ type ApiFakeOuterCompositeSerializeRequest struct {
 	outerComposite *OuterComposite
 }
 
+// Input composite as post body
 func (r ApiFakeOuterCompositeSerializeRequest) OuterComposite(outerComposite OuterComposite) ApiFakeOuterCompositeSerializeRequest {
 	r.outerComposite = &outerComposite
 	return r
@@ -460,11 +457,13 @@ func (r ApiFakeOuterCompositeSerializeRequest) Execute() (OuterComposite, *_neth
 }
 
 /*
- * FakeOuterCompositeSerialize Method for FakeOuterCompositeSerialize
- * Test serialization of object with outer number type
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiFakeOuterCompositeSerializeRequest
- */
+FakeOuterCompositeSerialize Method for FakeOuterCompositeSerialize
+
+Test serialization of object with outer number type
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiFakeOuterCompositeSerializeRequest
+*/
 func (a *FakeApiService) FakeOuterCompositeSerialize(ctx _context.Context) ApiFakeOuterCompositeSerializeRequest {
 	return ApiFakeOuterCompositeSerializeRequest{
 		ApiService: a,
@@ -472,10 +471,8 @@ func (a *FakeApiService) FakeOuterCompositeSerialize(ctx _context.Context) ApiFa
 	}
 }
 
-/*
- * Execute executes the request
- * @return OuterComposite
- */
+// Execute executes the request
+//  @return OuterComposite
 func (a *FakeApiService) FakeOuterCompositeSerializeExecute(r ApiFakeOuterCompositeSerializeRequest) (OuterComposite, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPost
@@ -559,6 +556,7 @@ type ApiFakeOuterNumberSerializeRequest struct {
 	body *float32
 }
 
+// Input number as post body
 func (r ApiFakeOuterNumberSerializeRequest) Body(body float32) ApiFakeOuterNumberSerializeRequest {
 	r.body = &body
 	return r
@@ -569,11 +567,13 @@ func (r ApiFakeOuterNumberSerializeRequest) Execute() (float32, *_nethttp.Respon
 }
 
 /*
- * FakeOuterNumberSerialize Method for FakeOuterNumberSerialize
- * Test serialization of outer number types
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiFakeOuterNumberSerializeRequest
- */
+FakeOuterNumberSerialize Method for FakeOuterNumberSerialize
+
+Test serialization of outer number types
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiFakeOuterNumberSerializeRequest
+*/
 func (a *FakeApiService) FakeOuterNumberSerialize(ctx _context.Context) ApiFakeOuterNumberSerializeRequest {
 	return ApiFakeOuterNumberSerializeRequest{
 		ApiService: a,
@@ -581,10 +581,8 @@ func (a *FakeApiService) FakeOuterNumberSerialize(ctx _context.Context) ApiFakeO
 	}
 }
 
-/*
- * Execute executes the request
- * @return float32
- */
+// Execute executes the request
+//  @return float32
 func (a *FakeApiService) FakeOuterNumberSerializeExecute(r ApiFakeOuterNumberSerializeRequest) (float32, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPost
@@ -668,6 +666,7 @@ type ApiFakeOuterStringSerializeRequest struct {
 	body *string
 }
 
+// Input string as post body
 func (r ApiFakeOuterStringSerializeRequest) Body(body string) ApiFakeOuterStringSerializeRequest {
 	r.body = &body
 	return r
@@ -678,11 +677,13 @@ func (r ApiFakeOuterStringSerializeRequest) Execute() (string, *_nethttp.Respons
 }
 
 /*
- * FakeOuterStringSerialize Method for FakeOuterStringSerialize
- * Test serialization of outer string types
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiFakeOuterStringSerializeRequest
- */
+FakeOuterStringSerialize Method for FakeOuterStringSerialize
+
+Test serialization of outer string types
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiFakeOuterStringSerializeRequest
+*/
 func (a *FakeApiService) FakeOuterStringSerialize(ctx _context.Context) ApiFakeOuterStringSerializeRequest {
 	return ApiFakeOuterStringSerializeRequest{
 		ApiService: a,
@@ -690,10 +691,8 @@ func (a *FakeApiService) FakeOuterStringSerialize(ctx _context.Context) ApiFakeO
 	}
 }
 
-/*
- * Execute executes the request
- * @return string
- */
+// Execute executes the request
+//  @return string
 func (a *FakeApiService) FakeOuterStringSerializeExecute(r ApiFakeOuterStringSerializeRequest) (string, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPost
@@ -787,11 +786,13 @@ func (r ApiTestBodyWithFileSchemaRequest) Execute() (*_nethttp.Response, error)
 }
 
 /*
- * TestBodyWithFileSchema Method for TestBodyWithFileSchema
- * For this test, the body for this request much reference a schema named `File`.
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiTestBodyWithFileSchemaRequest
- */
+TestBodyWithFileSchema Method for TestBodyWithFileSchema
+
+For this test, the body for this request much reference a schema named `File`.
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiTestBodyWithFileSchemaRequest
+*/
 func (a *FakeApiService) TestBodyWithFileSchema(ctx _context.Context) ApiTestBodyWithFileSchemaRequest {
 	return ApiTestBodyWithFileSchemaRequest{
 		ApiService: a,
@@ -799,9 +800,7 @@ func (a *FakeApiService) TestBodyWithFileSchema(ctx _context.Context) ApiTestBod
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *FakeApiService) TestBodyWithFileSchemaExecute(r ApiTestBodyWithFileSchemaRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPut
@@ -893,10 +892,11 @@ func (r ApiTestBodyWithQueryParamsRequest) Execute() (*_nethttp.Response, error)
 }
 
 /*
- * TestBodyWithQueryParams Method for TestBodyWithQueryParams
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiTestBodyWithQueryParamsRequest
- */
+TestBodyWithQueryParams Method for TestBodyWithQueryParams
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiTestBodyWithQueryParamsRequest
+*/
 func (a *FakeApiService) TestBodyWithQueryParams(ctx _context.Context) ApiTestBodyWithQueryParamsRequest {
 	return ApiTestBodyWithQueryParamsRequest{
 		ApiService: a,
@@ -904,9 +904,7 @@ func (a *FakeApiService) TestBodyWithQueryParams(ctx _context.Context) ApiTestBo
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *FakeApiService) TestBodyWithQueryParamsExecute(r ApiTestBodyWithQueryParamsRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPut
@@ -987,6 +985,7 @@ type ApiTestClientModelRequest struct {
 	client *Client
 }
 
+// client model
 func (r ApiTestClientModelRequest) Client(client Client) ApiTestClientModelRequest {
 	r.client = &client
 	return r
@@ -997,11 +996,13 @@ func (r ApiTestClientModelRequest) Execute() (Client, *_nethttp.Response, error)
 }
 
 /*
- * TestClientModel To test \"client\" model
- * To test "client" model
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiTestClientModelRequest
- */
+TestClientModel To test \"client\" model
+
+To test "client" model
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiTestClientModelRequest
+*/
 func (a *FakeApiService) TestClientModel(ctx _context.Context) ApiTestClientModelRequest {
 	return ApiTestClientModelRequest{
 		ApiService: a,
@@ -1009,10 +1010,8 @@ func (a *FakeApiService) TestClientModel(ctx _context.Context) ApiTestClientMode
 	}
 }
 
-/*
- * Execute executes the request
- * @return Client
- */
+// Execute executes the request
+//  @return Client
 func (a *FakeApiService) TestClientModelExecute(r ApiTestClientModelRequest) (Client, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPatch
@@ -1112,58 +1111,72 @@ type ApiTestEndpointParametersRequest struct {
 	callback *string
 }
 
+// None
 func (r ApiTestEndpointParametersRequest) Number(number float32) ApiTestEndpointParametersRequest {
 	r.number = &number
 	return r
 }
+// None
 func (r ApiTestEndpointParametersRequest) Double(double float64) ApiTestEndpointParametersRequest {
 	r.double = &double
 	return r
 }
+// None
 func (r ApiTestEndpointParametersRequest) PatternWithoutDelimiter(patternWithoutDelimiter string) ApiTestEndpointParametersRequest {
 	r.patternWithoutDelimiter = &patternWithoutDelimiter
 	return r
 }
+// None
 func (r ApiTestEndpointParametersRequest) Byte_(byte_ string) ApiTestEndpointParametersRequest {
 	r.byte_ = &byte_
 	return r
 }
+// None
 func (r ApiTestEndpointParametersRequest) Integer(integer int32) ApiTestEndpointParametersRequest {
 	r.integer = &integer
 	return r
 }
+// None
 func (r ApiTestEndpointParametersRequest) Int32_(int32_ int32) ApiTestEndpointParametersRequest {
 	r.int32_ = &int32_
 	return r
 }
+// None
 func (r ApiTestEndpointParametersRequest) Int64_(int64_ int64) ApiTestEndpointParametersRequest {
 	r.int64_ = &int64_
 	return r
 }
+// None
 func (r ApiTestEndpointParametersRequest) Float(float float32) ApiTestEndpointParametersRequest {
 	r.float = &float
 	return r
 }
+// None
 func (r ApiTestEndpointParametersRequest) String_(string_ string) ApiTestEndpointParametersRequest {
 	r.string_ = &string_
 	return r
 }
+// None
 func (r ApiTestEndpointParametersRequest) Binary(binary *os.File) ApiTestEndpointParametersRequest {
 	r.binary = &binary
 	return r
 }
+// None
 func (r ApiTestEndpointParametersRequest) Date(date string) ApiTestEndpointParametersRequest {
 	r.date = &date
 	return r
 }
+// None
 func (r ApiTestEndpointParametersRequest) DateTime(dateTime time.Time) ApiTestEndpointParametersRequest {
 	r.dateTime = &dateTime
 	return r
 }
+// None
 func (r ApiTestEndpointParametersRequest) Password(password string) ApiTestEndpointParametersRequest {
 	r.password = &password
 	return r
 }
+// None
 func (r ApiTestEndpointParametersRequest) Callback(callback string) ApiTestEndpointParametersRequest {
 	r.callback = &callback
 	return r
@@ -1174,15 +1187,17 @@ func (r ApiTestEndpointParametersRequest) Execute() (*_nethttp.Response, error)
 }
 
 /*
- * TestEndpointParameters Fake endpoint for testing various parameters 假端點 偽のエンドポイント 가짜 엔드 포인트 
- * Fake endpoint for testing various parameters
+TestEndpointParameters Fake endpoint for testing various parameters 假端點 偽のエンドポイント 가짜 엔드 포인트 
+
+Fake endpoint for testing various parameters
 假端點
 偽のエンドポイント
 가짜 엔드 포인트
 
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiTestEndpointParametersRequest
- */
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiTestEndpointParametersRequest
+*/
 func (a *FakeApiService) TestEndpointParameters(ctx _context.Context) ApiTestEndpointParametersRequest {
 	return ApiTestEndpointParametersRequest{
 		ApiService: a,
@@ -1190,9 +1205,7 @@ func (a *FakeApiService) TestEndpointParameters(ctx _context.Context) ApiTestEnd
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *FakeApiService) TestEndpointParametersExecute(r ApiTestEndpointParametersRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPost
@@ -1337,34 +1350,42 @@ type ApiTestEnumParametersRequest struct {
 	enumFormString *string
 }
 
+// Header parameter enum test (string array)
 func (r ApiTestEnumParametersRequest) EnumHeaderStringArray(enumHeaderStringArray []string) ApiTestEnumParametersRequest {
 	r.enumHeaderStringArray = &enumHeaderStringArray
 	return r
 }
+// Header parameter enum test (string)
 func (r ApiTestEnumParametersRequest) EnumHeaderString(enumHeaderString string) ApiTestEnumParametersRequest {
 	r.enumHeaderString = &enumHeaderString
 	return r
 }
+// Query parameter enum test (string array)
 func (r ApiTestEnumParametersRequest) EnumQueryStringArray(enumQueryStringArray []string) ApiTestEnumParametersRequest {
 	r.enumQueryStringArray = &enumQueryStringArray
 	return r
 }
+// Query parameter enum test (string)
 func (r ApiTestEnumParametersRequest) EnumQueryString(enumQueryString string) ApiTestEnumParametersRequest {
 	r.enumQueryString = &enumQueryString
 	return r
 }
+// Query parameter enum test (double)
 func (r ApiTestEnumParametersRequest) EnumQueryInteger(enumQueryInteger int32) ApiTestEnumParametersRequest {
 	r.enumQueryInteger = &enumQueryInteger
 	return r
 }
+// Query parameter enum test (double)
 func (r ApiTestEnumParametersRequest) EnumQueryDouble(enumQueryDouble float64) ApiTestEnumParametersRequest {
 	r.enumQueryDouble = &enumQueryDouble
 	return r
 }
+// Form parameter enum test (string array)
 func (r ApiTestEnumParametersRequest) EnumFormStringArray(enumFormStringArray []string) ApiTestEnumParametersRequest {
 	r.enumFormStringArray = &enumFormStringArray
 	return r
 }
+// Form parameter enum test (string)
 func (r ApiTestEnumParametersRequest) EnumFormString(enumFormString string) ApiTestEnumParametersRequest {
 	r.enumFormString = &enumFormString
 	return r
@@ -1375,11 +1396,13 @@ func (r ApiTestEnumParametersRequest) Execute() (*_nethttp.Response, error) {
 }
 
 /*
- * TestEnumParameters To test enum parameters
- * To test enum parameters
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiTestEnumParametersRequest
- */
+TestEnumParameters To test enum parameters
+
+To test enum parameters
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiTestEnumParametersRequest
+*/
 func (a *FakeApiService) TestEnumParameters(ctx _context.Context) ApiTestEnumParametersRequest {
 	return ApiTestEnumParametersRequest{
 		ApiService: a,
@@ -1387,9 +1410,7 @@ func (a *FakeApiService) TestEnumParameters(ctx _context.Context) ApiTestEnumPar
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *FakeApiService) TestEnumParametersExecute(r ApiTestEnumParametersRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodGet
@@ -1498,26 +1519,32 @@ type ApiTestGroupParametersRequest struct {
 	int64Group *int64
 }
 
+// Required String in group parameters
 func (r ApiTestGroupParametersRequest) RequiredStringGroup(requiredStringGroup int32) ApiTestGroupParametersRequest {
 	r.requiredStringGroup = &requiredStringGroup
 	return r
 }
+// Required Boolean in group parameters
 func (r ApiTestGroupParametersRequest) RequiredBooleanGroup(requiredBooleanGroup bool) ApiTestGroupParametersRequest {
 	r.requiredBooleanGroup = &requiredBooleanGroup
 	return r
 }
+// Required Integer in group parameters
 func (r ApiTestGroupParametersRequest) RequiredInt64Group(requiredInt64Group int64) ApiTestGroupParametersRequest {
 	r.requiredInt64Group = &requiredInt64Group
 	return r
 }
+// String in group parameters
 func (r ApiTestGroupParametersRequest) StringGroup(stringGroup int32) ApiTestGroupParametersRequest {
 	r.stringGroup = &stringGroup
 	return r
 }
+// Boolean in group parameters
 func (r ApiTestGroupParametersRequest) BooleanGroup(booleanGroup bool) ApiTestGroupParametersRequest {
 	r.booleanGroup = &booleanGroup
 	return r
 }
+// Integer in group parameters
 func (r ApiTestGroupParametersRequest) Int64Group(int64Group int64) ApiTestGroupParametersRequest {
 	r.int64Group = &int64Group
 	return r
@@ -1528,11 +1555,13 @@ func (r ApiTestGroupParametersRequest) Execute() (*_nethttp.Response, error) {
 }
 
 /*
- * TestGroupParameters Fake endpoint to test group parameters (optional)
- * Fake endpoint to test group parameters (optional)
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiTestGroupParametersRequest
- */
+TestGroupParameters Fake endpoint to test group parameters (optional)
+
+Fake endpoint to test group parameters (optional)
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiTestGroupParametersRequest
+*/
 func (a *FakeApiService) TestGroupParameters(ctx _context.Context) ApiTestGroupParametersRequest {
 	return ApiTestGroupParametersRequest{
 		ApiService: a,
@@ -1540,9 +1569,7 @@ func (a *FakeApiService) TestGroupParameters(ctx _context.Context) ApiTestGroupP
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *FakeApiService) TestGroupParametersExecute(r ApiTestGroupParametersRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodDelete
@@ -1635,6 +1662,7 @@ type ApiTestInlineAdditionalPropertiesRequest struct {
 	requestBody *map[string]string
 }
 
+// request body
 func (r ApiTestInlineAdditionalPropertiesRequest) RequestBody(requestBody map[string]string) ApiTestInlineAdditionalPropertiesRequest {
 	r.requestBody = &requestBody
 	return r
@@ -1645,10 +1673,11 @@ func (r ApiTestInlineAdditionalPropertiesRequest) Execute() (*_nethttp.Response,
 }
 
 /*
- * TestInlineAdditionalProperties test inline additionalProperties
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiTestInlineAdditionalPropertiesRequest
- */
+TestInlineAdditionalProperties test inline additionalProperties
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiTestInlineAdditionalPropertiesRequest
+*/
 func (a *FakeApiService) TestInlineAdditionalProperties(ctx _context.Context) ApiTestInlineAdditionalPropertiesRequest {
 	return ApiTestInlineAdditionalPropertiesRequest{
 		ApiService: a,
@@ -1656,9 +1685,7 @@ func (a *FakeApiService) TestInlineAdditionalProperties(ctx _context.Context) Ap
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *FakeApiService) TestInlineAdditionalPropertiesExecute(r ApiTestInlineAdditionalPropertiesRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPost
@@ -1736,10 +1763,12 @@ type ApiTestJsonFormDataRequest struct {
 	param2 *string
 }
 
+// field1
 func (r ApiTestJsonFormDataRequest) Param(param string) ApiTestJsonFormDataRequest {
 	r.param = &param
 	return r
 }
+// field2
 func (r ApiTestJsonFormDataRequest) Param2(param2 string) ApiTestJsonFormDataRequest {
 	r.param2 = &param2
 	return r
@@ -1750,10 +1779,11 @@ func (r ApiTestJsonFormDataRequest) Execute() (*_nethttp.Response, error) {
 }
 
 /*
- * TestJsonFormData test json serialization of form data
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiTestJsonFormDataRequest
- */
+TestJsonFormData test json serialization of form data
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiTestJsonFormDataRequest
+*/
 func (a *FakeApiService) TestJsonFormData(ctx _context.Context) ApiTestJsonFormDataRequest {
 	return ApiTestJsonFormDataRequest{
 		ApiService: a,
@@ -1761,9 +1791,7 @@ func (a *FakeApiService) TestJsonFormData(ctx _context.Context) ApiTestJsonFormD
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *FakeApiService) TestJsonFormDataExecute(r ApiTestJsonFormDataRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodGet
@@ -1873,11 +1901,13 @@ func (r ApiTestQueryParameterCollectionFormatRequest) Execute() (*_nethttp.Respo
 }
 
 /*
- * TestQueryParameterCollectionFormat Method for TestQueryParameterCollectionFormat
- * To test the collection format in query parameters
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiTestQueryParameterCollectionFormatRequest
- */
+TestQueryParameterCollectionFormat Method for TestQueryParameterCollectionFormat
+
+To test the collection format in query parameters
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiTestQueryParameterCollectionFormatRequest
+*/
 func (a *FakeApiService) TestQueryParameterCollectionFormat(ctx _context.Context) ApiTestQueryParameterCollectionFormatRequest {
 	return ApiTestQueryParameterCollectionFormatRequest{
 		ApiService: a,
@@ -1885,9 +1915,7 @@ func (a *FakeApiService) TestQueryParameterCollectionFormat(ctx _context.Context
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *FakeApiService) TestQueryParameterCollectionFormatExecute(r ApiTestQueryParameterCollectionFormatRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPut
@@ -2014,11 +2042,13 @@ func (r ApiTestUniqueItemsHeaderAndQueryParameterCollectionFormatRequest) Execut
 }
 
 /*
- * TestUniqueItemsHeaderAndQueryParameterCollectionFormat Method for TestUniqueItemsHeaderAndQueryParameterCollectionFormat
- * To test unique items in header and query parameters
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiTestUniqueItemsHeaderAndQueryParameterCollectionFormatRequest
- */
+TestUniqueItemsHeaderAndQueryParameterCollectionFormat Method for TestUniqueItemsHeaderAndQueryParameterCollectionFormat
+
+To test unique items in header and query parameters
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiTestUniqueItemsHeaderAndQueryParameterCollectionFormatRequest
+*/
 func (a *FakeApiService) TestUniqueItemsHeaderAndQueryParameterCollectionFormat(ctx _context.Context) ApiTestUniqueItemsHeaderAndQueryParameterCollectionFormatRequest {
 	return ApiTestUniqueItemsHeaderAndQueryParameterCollectionFormatRequest{
 		ApiService: a,
@@ -2026,10 +2056,8 @@ func (a *FakeApiService) TestUniqueItemsHeaderAndQueryParameterCollectionFormat(
 	}
 }
 
-/*
- * Execute executes the request
- * @return []Pet
- */
+// Execute executes the request
+//  @return []Pet
 func (a *FakeApiService) TestUniqueItemsHeaderAndQueryParameterCollectionFormatExecute(r ApiTestUniqueItemsHeaderAndQueryParameterCollectionFormatRequest) ([]Pet, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPut

samples/openapi3/client/petstore/go/go-petstore/api_fake_classname_tags123.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 
@@ -26,17 +26,17 @@ var (
 type FakeClassnameTags123Api interface {
 
 	/*
-	 * TestClassname To test class name in snake case
-	 * To test class name in snake case
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiTestClassnameRequest
+	TestClassname To test class name in snake case
+
+	To test class name in snake case
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiTestClassnameRequest
 	*/
 	TestClassname(ctx _context.Context) ApiTestClassnameRequest
 
-	/*
-	 * TestClassnameExecute executes the request
-	 * @return Client
-	 */
+	// TestClassnameExecute executes the request
+	//  @return Client
 	TestClassnameExecute(r ApiTestClassnameRequest) (Client, *_nethttp.Response, error)
 }
 
@@ -49,6 +49,7 @@ type ApiTestClassnameRequest struct {
 	client *Client
 }
 
+// client model
 func (r ApiTestClassnameRequest) Client(client Client) ApiTestClassnameRequest {
 	r.client = &client
 	return r
@@ -59,11 +60,13 @@ func (r ApiTestClassnameRequest) Execute() (Client, *_nethttp.Response, error) {
 }
 
 /*
- * TestClassname To test class name in snake case
- * To test class name in snake case
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiTestClassnameRequest
- */
+TestClassname To test class name in snake case
+
+To test class name in snake case
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiTestClassnameRequest
+*/
 func (a *FakeClassnameTags123ApiService) TestClassname(ctx _context.Context) ApiTestClassnameRequest {
 	return ApiTestClassnameRequest{
 		ApiService: a,
@@ -71,10 +74,8 @@ func (a *FakeClassnameTags123ApiService) TestClassname(ctx _context.Context) Api
 	}
 }
 
-/*
- * Execute executes the request
- * @return Client
- */
+// Execute executes the request
+//  @return Client
 func (a *FakeClassnameTags123ApiService) TestClassnameExecute(r ApiTestClassnameRequest) (Client, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPatch

samples/openapi3/client/petstore/go/go-petstore/api_pet.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 
@@ -28,124 +28,121 @@ var (
 type PetApi interface {
 
 	/*
-	 * AddPet Add a new pet to the store
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiAddPetRequest
+	AddPet Add a new pet to the store
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiAddPetRequest
 	*/
 	AddPet(ctx _context.Context) ApiAddPetRequest
 
-	/*
-	 * AddPetExecute executes the request
-	 */
+	// AddPetExecute executes the request
 	AddPetExecute(r ApiAddPetRequest) (*_nethttp.Response, error)
 
 	/*
-	 * DeletePet Deletes a pet
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @param petId Pet id to delete
-	 * @return ApiDeletePetRequest
+	DeletePet Deletes a pet
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @param petId Pet id to delete
+	 @return ApiDeletePetRequest
 	*/
 	DeletePet(ctx _context.Context, petId int64) ApiDeletePetRequest
 
-	/*
-	 * DeletePetExecute executes the request
-	 */
+	// DeletePetExecute executes the request
 	DeletePetExecute(r ApiDeletePetRequest) (*_nethttp.Response, error)
 
 	/*
-	 * FindPetsByStatus Finds Pets by status
-	 * Multiple status values can be provided with comma separated strings
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiFindPetsByStatusRequest
+	FindPetsByStatus Finds Pets by status
+
+	Multiple status values can be provided with comma separated strings
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiFindPetsByStatusRequest
 	*/
 	FindPetsByStatus(ctx _context.Context) ApiFindPetsByStatusRequest
 
-	/*
-	 * FindPetsByStatusExecute executes the request
-	 * @return []Pet
-	 */
+	// FindPetsByStatusExecute executes the request
+	//  @return []Pet
 	FindPetsByStatusExecute(r ApiFindPetsByStatusRequest) ([]Pet, *_nethttp.Response, error)
 
 	/*
-	 * FindPetsByTags Finds Pets by tags
-	 * Multiple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiFindPetsByTagsRequest
+	FindPetsByTags Finds Pets by tags
+
+	Multiple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiFindPetsByTagsRequest
+
+	Deprecated
 	*/
 	FindPetsByTags(ctx _context.Context) ApiFindPetsByTagsRequest
 
-	/*
-	 * FindPetsByTagsExecute executes the request
-	 * @return []Pet
-	 */
+	// FindPetsByTagsExecute executes the request
+	//  @return []Pet
+	// Deprecated
 	FindPetsByTagsExecute(r ApiFindPetsByTagsRequest) ([]Pet, *_nethttp.Response, error)
 
 	/*
-	 * GetPetById Find pet by ID
-	 * Returns a single pet
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @param petId ID of pet to return
-	 * @return ApiGetPetByIdRequest
+	GetPetById Find pet by ID
+
+	Returns a single pet
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @param petId ID of pet to return
+	 @return ApiGetPetByIdRequest
 	*/
 	GetPetById(ctx _context.Context, petId int64) ApiGetPetByIdRequest
 
-	/*
-	 * GetPetByIdExecute executes the request
-	 * @return Pet
-	 */
+	// GetPetByIdExecute executes the request
+	//  @return Pet
 	GetPetByIdExecute(r ApiGetPetByIdRequest) (Pet, *_nethttp.Response, error)
 
 	/*
-	 * UpdatePet Update an existing pet
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiUpdatePetRequest
+	UpdatePet Update an existing pet
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiUpdatePetRequest
 	*/
 	UpdatePet(ctx _context.Context) ApiUpdatePetRequest
 
-	/*
-	 * UpdatePetExecute executes the request
-	 */
+	// UpdatePetExecute executes the request
 	UpdatePetExecute(r ApiUpdatePetRequest) (*_nethttp.Response, error)
 
 	/*
-	 * UpdatePetWithForm Updates a pet in the store with form data
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @param petId ID of pet that needs to be updated
-	 * @return ApiUpdatePetWithFormRequest
+	UpdatePetWithForm Updates a pet in the store with form data
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @param petId ID of pet that needs to be updated
+	 @return ApiUpdatePetWithFormRequest
 	*/
 	UpdatePetWithForm(ctx _context.Context, petId int64) ApiUpdatePetWithFormRequest
 
-	/*
-	 * UpdatePetWithFormExecute executes the request
-	 */
+	// UpdatePetWithFormExecute executes the request
 	UpdatePetWithFormExecute(r ApiUpdatePetWithFormRequest) (*_nethttp.Response, error)
 
 	/*
-	 * UploadFile uploads an image
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @param petId ID of pet to update
-	 * @return ApiUploadFileRequest
+	UploadFile uploads an image
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @param petId ID of pet to update
+	 @return ApiUploadFileRequest
 	*/
 	UploadFile(ctx _context.Context, petId int64) ApiUploadFileRequest
 
-	/*
-	 * UploadFileExecute executes the request
-	 * @return ApiResponse
-	 */
+	// UploadFileExecute executes the request
+	//  @return ApiResponse
 	UploadFileExecute(r ApiUploadFileRequest) (ApiResponse, *_nethttp.Response, error)
 
 	/*
-	 * UploadFileWithRequiredFile uploads an image (required)
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @param petId ID of pet to update
-	 * @return ApiUploadFileWithRequiredFileRequest
+	UploadFileWithRequiredFile uploads an image (required)
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @param petId ID of pet to update
+	 @return ApiUploadFileWithRequiredFileRequest
 	*/
 	UploadFileWithRequiredFile(ctx _context.Context, petId int64) ApiUploadFileWithRequiredFileRequest
 
-	/*
-	 * UploadFileWithRequiredFileExecute executes the request
-	 * @return ApiResponse
-	 */
+	// UploadFileWithRequiredFileExecute executes the request
+	//  @return ApiResponse
 	UploadFileWithRequiredFileExecute(r ApiUploadFileWithRequiredFileRequest) (ApiResponse, *_nethttp.Response, error)
 }
 
@@ -158,6 +155,7 @@ type ApiAddPetRequest struct {
 	pet *Pet
 }
 
+// Pet object that needs to be added to the store
 func (r ApiAddPetRequest) Pet(pet Pet) ApiAddPetRequest {
 	r.pet = &pet
 	return r
@@ -168,10 +166,11 @@ func (r ApiAddPetRequest) Execute() (*_nethttp.Response, error) {
 }
 
 /*
- * AddPet Add a new pet to the store
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiAddPetRequest
- */
+AddPet Add a new pet to the store
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiAddPetRequest
+*/
 func (a *PetApiService) AddPet(ctx _context.Context) ApiAddPetRequest {
 	return ApiAddPetRequest{
 		ApiService: a,
@@ -179,9 +178,7 @@ func (a *PetApiService) AddPet(ctx _context.Context) ApiAddPetRequest {
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *PetApiService) AddPetExecute(r ApiAddPetRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPost
@@ -269,11 +266,12 @@ func (r ApiDeletePetRequest) Execute() (*_nethttp.Response, error) {
 }
 
 /*
- * DeletePet Deletes a pet
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @param petId Pet id to delete
- * @return ApiDeletePetRequest
- */
+DeletePet Deletes a pet
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @param petId Pet id to delete
+ @return ApiDeletePetRequest
+*/
 func (a *PetApiService) DeletePet(ctx _context.Context, petId int64) ApiDeletePetRequest {
 	return ApiDeletePetRequest{
 		ApiService: a,
@@ -282,9 +280,7 @@ func (a *PetApiService) DeletePet(ctx _context.Context, petId int64) ApiDeletePe
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *PetApiService) DeletePetExecute(r ApiDeletePetRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodDelete
@@ -360,6 +356,8 @@ type ApiFindPetsByStatusRequest struct {
 	status *[]string
 }
 
+// Status values that need to be considered for filter
+// Deprecated
 func (r ApiFindPetsByStatusRequest) Status(status []string) ApiFindPetsByStatusRequest {
 	r.status = &status
 	return r
@@ -370,11 +368,13 @@ func (r ApiFindPetsByStatusRequest) Execute() ([]Pet, *_nethttp.Response, error)
 }
 
 /*
- * FindPetsByStatus Finds Pets by status
- * Multiple status values can be provided with comma separated strings
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiFindPetsByStatusRequest
- */
+FindPetsByStatus Finds Pets by status
+
+Multiple status values can be provided with comma separated strings
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiFindPetsByStatusRequest
+*/
 func (a *PetApiService) FindPetsByStatus(ctx _context.Context) ApiFindPetsByStatusRequest {
 	return ApiFindPetsByStatusRequest{
 		ApiService: a,
@@ -382,10 +382,8 @@ func (a *PetApiService) FindPetsByStatus(ctx _context.Context) ApiFindPetsByStat
 	}
 }
 
-/*
- * Execute executes the request
- * @return []Pet
- */
+// Execute executes the request
+//  @return []Pet
 func (a *PetApiService) FindPetsByStatusExecute(r ApiFindPetsByStatusRequest) ([]Pet, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodGet
@@ -471,6 +469,7 @@ type ApiFindPetsByTagsRequest struct {
 	tags *[]string
 }
 
+// Tags to filter by
 func (r ApiFindPetsByTagsRequest) Tags(tags []string) ApiFindPetsByTagsRequest {
 	r.tags = &tags
 	return r
@@ -481,11 +480,15 @@ func (r ApiFindPetsByTagsRequest) Execute() ([]Pet, *_nethttp.Response, error) {
 }
 
 /*
- * FindPetsByTags Finds Pets by tags
- * Multiple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiFindPetsByTagsRequest
- */
+FindPetsByTags Finds Pets by tags
+
+Multiple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiFindPetsByTagsRequest
+
+Deprecated
+*/
 func (a *PetApiService) FindPetsByTags(ctx _context.Context) ApiFindPetsByTagsRequest {
 	return ApiFindPetsByTagsRequest{
 		ApiService: a,
@@ -493,10 +496,9 @@ func (a *PetApiService) FindPetsByTags(ctx _context.Context) ApiFindPetsByTagsRe
 	}
 }
 
-/*
- * Execute executes the request
- * @return []Pet
- */
+// Execute executes the request
+//  @return []Pet
+// Deprecated
 func (a *PetApiService) FindPetsByTagsExecute(r ApiFindPetsByTagsRequest) ([]Pet, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodGet
@@ -588,12 +590,14 @@ func (r ApiGetPetByIdRequest) Execute() (Pet, *_nethttp.Response, error) {
 }
 
 /*
- * GetPetById Find pet by ID
- * Returns a single pet
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @param petId ID of pet to return
- * @return ApiGetPetByIdRequest
- */
+GetPetById Find pet by ID
+
+Returns a single pet
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @param petId ID of pet to return
+ @return ApiGetPetByIdRequest
+*/
 func (a *PetApiService) GetPetById(ctx _context.Context, petId int64) ApiGetPetByIdRequest {
 	return ApiGetPetByIdRequest{
 		ApiService: a,
@@ -602,10 +606,8 @@ func (a *PetApiService) GetPetById(ctx _context.Context, petId int64) ApiGetPetB
 	}
 }
 
-/*
- * Execute executes the request
- * @return Pet
- */
+// Execute executes the request
+//  @return Pet
 func (a *PetApiService) GetPetByIdExecute(r ApiGetPetByIdRequest) (Pet, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodGet
@@ -702,6 +704,7 @@ type ApiUpdatePetRequest struct {
 	pet *Pet
 }
 
+// Pet object that needs to be added to the store
 func (r ApiUpdatePetRequest) Pet(pet Pet) ApiUpdatePetRequest {
 	r.pet = &pet
 	return r
@@ -712,10 +715,11 @@ func (r ApiUpdatePetRequest) Execute() (*_nethttp.Response, error) {
 }
 
 /*
- * UpdatePet Update an existing pet
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiUpdatePetRequest
- */
+UpdatePet Update an existing pet
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiUpdatePetRequest
+*/
 func (a *PetApiService) UpdatePet(ctx _context.Context) ApiUpdatePetRequest {
 	return ApiUpdatePetRequest{
 		ApiService: a,
@@ -723,9 +727,7 @@ func (a *PetApiService) UpdatePet(ctx _context.Context) ApiUpdatePetRequest {
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *PetApiService) UpdatePetExecute(r ApiUpdatePetRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPut
@@ -804,10 +806,12 @@ type ApiUpdatePetWithFormRequest struct {
 	status *string
 }
 
+// Updated name of the pet
 func (r ApiUpdatePetWithFormRequest) Name(name string) ApiUpdatePetWithFormRequest {
 	r.name = &name
 	return r
 }
+// Updated status of the pet
 func (r ApiUpdatePetWithFormRequest) Status(status string) ApiUpdatePetWithFormRequest {
 	r.status = &status
 	return r
@@ -818,11 +822,12 @@ func (r ApiUpdatePetWithFormRequest) Execute() (*_nethttp.Response, error) {
 }
 
 /*
- * UpdatePetWithForm Updates a pet in the store with form data
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @param petId ID of pet that needs to be updated
- * @return ApiUpdatePetWithFormRequest
- */
+UpdatePetWithForm Updates a pet in the store with form data
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @param petId ID of pet that needs to be updated
+ @return ApiUpdatePetWithFormRequest
+*/
 func (a *PetApiService) UpdatePetWithForm(ctx _context.Context, petId int64) ApiUpdatePetWithFormRequest {
 	return ApiUpdatePetWithFormRequest{
 		ApiService: a,
@@ -831,9 +836,7 @@ func (a *PetApiService) UpdatePetWithForm(ctx _context.Context, petId int64) Api
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *PetApiService) UpdatePetWithFormExecute(r ApiUpdatePetWithFormRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPost
@@ -914,10 +917,12 @@ type ApiUploadFileRequest struct {
 	file **os.File
 }
 
+// Additional data to pass to server
 func (r ApiUploadFileRequest) AdditionalMetadata(additionalMetadata string) ApiUploadFileRequest {
 	r.additionalMetadata = &additionalMetadata
 	return r
 }
+// file to upload
 func (r ApiUploadFileRequest) File(file *os.File) ApiUploadFileRequest {
 	r.file = &file
 	return r
@@ -928,11 +933,12 @@ func (r ApiUploadFileRequest) Execute() (ApiResponse, *_nethttp.Response, error)
 }
 
 /*
- * UploadFile uploads an image
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @param petId ID of pet to update
- * @return ApiUploadFileRequest
- */
+UploadFile uploads an image
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @param petId ID of pet to update
+ @return ApiUploadFileRequest
+*/
 func (a *PetApiService) UploadFile(ctx _context.Context, petId int64) ApiUploadFileRequest {
 	return ApiUploadFileRequest{
 		ApiService: a,
@@ -941,10 +947,8 @@ func (a *PetApiService) UploadFile(ctx _context.Context, petId int64) ApiUploadF
 	}
 }
 
-/*
- * Execute executes the request
- * @return ApiResponse
- */
+// Execute executes the request
+//  @return ApiResponse
 func (a *PetApiService) UploadFileExecute(r ApiUploadFileRequest) (ApiResponse, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPost
@@ -1043,10 +1047,12 @@ type ApiUploadFileWithRequiredFileRequest struct {
 	additionalMetadata *string
 }
 
+// file to upload
 func (r ApiUploadFileWithRequiredFileRequest) RequiredFile(requiredFile *os.File) ApiUploadFileWithRequiredFileRequest {
 	r.requiredFile = &requiredFile
 	return r
 }
+// Additional data to pass to server
 func (r ApiUploadFileWithRequiredFileRequest) AdditionalMetadata(additionalMetadata string) ApiUploadFileWithRequiredFileRequest {
 	r.additionalMetadata = &additionalMetadata
 	return r
@@ -1057,11 +1063,12 @@ func (r ApiUploadFileWithRequiredFileRequest) Execute() (ApiResponse, *_nethttp.
 }
 
 /*
- * UploadFileWithRequiredFile uploads an image (required)
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @param petId ID of pet to update
- * @return ApiUploadFileWithRequiredFileRequest
- */
+UploadFileWithRequiredFile uploads an image (required)
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @param petId ID of pet to update
+ @return ApiUploadFileWithRequiredFileRequest
+*/
 func (a *PetApiService) UploadFileWithRequiredFile(ctx _context.Context, petId int64) ApiUploadFileWithRequiredFileRequest {
 	return ApiUploadFileWithRequiredFileRequest{
 		ApiService: a,
@@ -1070,10 +1077,8 @@ func (a *PetApiService) UploadFileWithRequiredFile(ctx _context.Context, petId i
 	}
 }
 
-/*
- * Execute executes the request
- * @return ApiResponse
- */
+// Execute executes the request
+//  @return ApiResponse
 func (a *PetApiService) UploadFileWithRequiredFileExecute(r ApiUploadFileWithRequiredFileRequest) (ApiResponse, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPost

samples/openapi3/client/petstore/go/go-petstore/api_store.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 
@@ -27,59 +27,58 @@ var (
 type StoreApi interface {
 
 	/*
-	 * DeleteOrder Delete purchase order by ID
-	 * For valid response try integer IDs with value < 1000. Anything above 1000 or nonintegers will generate API errors
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @param orderId ID of the order that needs to be deleted
-	 * @return ApiDeleteOrderRequest
+	DeleteOrder Delete purchase order by ID
+
+	For valid response try integer IDs with value < 1000. Anything above 1000 or nonintegers will generate API errors
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @param orderId ID of the order that needs to be deleted
+	 @return ApiDeleteOrderRequest
 	*/
 	DeleteOrder(ctx _context.Context, orderId string) ApiDeleteOrderRequest
 
-	/*
-	 * DeleteOrderExecute executes the request
-	 */
+	// DeleteOrderExecute executes the request
 	DeleteOrderExecute(r ApiDeleteOrderRequest) (*_nethttp.Response, error)
 
 	/*
-	 * GetInventory Returns pet inventories by status
-	 * Returns a map of status codes to quantities
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiGetInventoryRequest
+	GetInventory Returns pet inventories by status
+
+	Returns a map of status codes to quantities
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiGetInventoryRequest
 	*/
 	GetInventory(ctx _context.Context) ApiGetInventoryRequest
 
-	/*
-	 * GetInventoryExecute executes the request
-	 * @return map[string]int32
-	 */
+	// GetInventoryExecute executes the request
+	//  @return map[string]int32
 	GetInventoryExecute(r ApiGetInventoryRequest) (map[string]int32, *_nethttp.Response, error)
 
 	/*
-	 * GetOrderById Find purchase order by ID
-	 * For valid response try integer IDs with value <= 5 or > 10. Other values will generated exceptions
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @param orderId ID of pet that needs to be fetched
-	 * @return ApiGetOrderByIdRequest
+	GetOrderById Find purchase order by ID
+
+	For valid response try integer IDs with value <= 5 or > 10. Other values will generated exceptions
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @param orderId ID of pet that needs to be fetched
+	 @return ApiGetOrderByIdRequest
 	*/
 	GetOrderById(ctx _context.Context, orderId int64) ApiGetOrderByIdRequest
 
-	/*
-	 * GetOrderByIdExecute executes the request
-	 * @return Order
-	 */
+	// GetOrderByIdExecute executes the request
+	//  @return Order
 	GetOrderByIdExecute(r ApiGetOrderByIdRequest) (Order, *_nethttp.Response, error)
 
 	/*
-	 * PlaceOrder Place an order for a pet
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiPlaceOrderRequest
+	PlaceOrder Place an order for a pet
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiPlaceOrderRequest
 	*/
 	PlaceOrder(ctx _context.Context) ApiPlaceOrderRequest
 
-	/*
-	 * PlaceOrderExecute executes the request
-	 * @return Order
-	 */
+	// PlaceOrderExecute executes the request
+	//  @return Order
 	PlaceOrderExecute(r ApiPlaceOrderRequest) (Order, *_nethttp.Response, error)
 }
 
@@ -98,12 +97,14 @@ func (r ApiDeleteOrderRequest) Execute() (*_nethttp.Response, error) {
 }
 
 /*
- * DeleteOrder Delete purchase order by ID
- * For valid response try integer IDs with value < 1000. Anything above 1000 or nonintegers will generate API errors
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @param orderId ID of the order that needs to be deleted
- * @return ApiDeleteOrderRequest
- */
+DeleteOrder Delete purchase order by ID
+
+For valid response try integer IDs with value < 1000. Anything above 1000 or nonintegers will generate API errors
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @param orderId ID of the order that needs to be deleted
+ @return ApiDeleteOrderRequest
+*/
 func (a *StoreApiService) DeleteOrder(ctx _context.Context, orderId string) ApiDeleteOrderRequest {
 	return ApiDeleteOrderRequest{
 		ApiService: a,
@@ -112,9 +113,7 @@ func (a *StoreApiService) DeleteOrder(ctx _context.Context, orderId string) ApiD
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *StoreApiService) DeleteOrderExecute(r ApiDeleteOrderRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodDelete
@@ -192,11 +191,13 @@ func (r ApiGetInventoryRequest) Execute() (map[string]int32, *_nethttp.Response,
 }
 
 /*
- * GetInventory Returns pet inventories by status
- * Returns a map of status codes to quantities
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiGetInventoryRequest
- */
+GetInventory Returns pet inventories by status
+
+Returns a map of status codes to quantities
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiGetInventoryRequest
+*/
 func (a *StoreApiService) GetInventory(ctx _context.Context) ApiGetInventoryRequest {
 	return ApiGetInventoryRequest{
 		ApiService: a,
@@ -204,10 +205,8 @@ func (a *StoreApiService) GetInventory(ctx _context.Context) ApiGetInventoryRequ
 	}
 }
 
-/*
- * Execute executes the request
- * @return map[string]int32
- */
+// Execute executes the request
+//  @return map[string]int32
 func (a *StoreApiService) GetInventoryExecute(r ApiGetInventoryRequest) (map[string]int32, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodGet
@@ -309,12 +308,14 @@ func (r ApiGetOrderByIdRequest) Execute() (Order, *_nethttp.Response, error) {
 }
 
 /*
- * GetOrderById Find purchase order by ID
- * For valid response try integer IDs with value <= 5 or > 10. Other values will generated exceptions
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @param orderId ID of pet that needs to be fetched
- * @return ApiGetOrderByIdRequest
- */
+GetOrderById Find purchase order by ID
+
+For valid response try integer IDs with value <= 5 or > 10. Other values will generated exceptions
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @param orderId ID of pet that needs to be fetched
+ @return ApiGetOrderByIdRequest
+*/
 func (a *StoreApiService) GetOrderById(ctx _context.Context, orderId int64) ApiGetOrderByIdRequest {
 	return ApiGetOrderByIdRequest{
 		ApiService: a,
@@ -323,10 +324,8 @@ func (a *StoreApiService) GetOrderById(ctx _context.Context, orderId int64) ApiG
 	}
 }
 
-/*
- * Execute executes the request
- * @return Order
- */
+// Execute executes the request
+//  @return Order
 func (a *StoreApiService) GetOrderByIdExecute(r ApiGetOrderByIdRequest) (Order, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodGet
@@ -415,6 +414,7 @@ type ApiPlaceOrderRequest struct {
 	order *Order
 }
 
+// order placed for purchasing the pet
 func (r ApiPlaceOrderRequest) Order(order Order) ApiPlaceOrderRequest {
 	r.order = &order
 	return r
@@ -425,10 +425,11 @@ func (r ApiPlaceOrderRequest) Execute() (Order, *_nethttp.Response, error) {
 }
 
 /*
- * PlaceOrder Place an order for a pet
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiPlaceOrderRequest
- */
+PlaceOrder Place an order for a pet
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiPlaceOrderRequest
+*/
 func (a *StoreApiService) PlaceOrder(ctx _context.Context) ApiPlaceOrderRequest {
 	return ApiPlaceOrderRequest{
 		ApiService: a,
@@ -436,10 +437,8 @@ func (a *StoreApiService) PlaceOrder(ctx _context.Context) ApiPlaceOrderRequest
 	}
 }
 
-/*
- * Execute executes the request
- * @return Order
- */
+// Execute executes the request
+//  @return Order
 func (a *StoreApiService) PlaceOrderExecute(r ApiPlaceOrderRequest) (Order, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPost

samples/openapi3/client/petstore/go/go-petstore/api_user.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 
@@ -27,107 +27,102 @@ var (
 type UserApi interface {
 
 	/*
-	 * CreateUser Create user
-	 * This can only be done by the logged in user.
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiCreateUserRequest
+	CreateUser Create user
+
+	This can only be done by the logged in user.
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiCreateUserRequest
 	*/
 	CreateUser(ctx _context.Context) ApiCreateUserRequest
 
-	/*
-	 * CreateUserExecute executes the request
-	 */
+	// CreateUserExecute executes the request
 	CreateUserExecute(r ApiCreateUserRequest) (*_nethttp.Response, error)
 
 	/*
-	 * CreateUsersWithArrayInput Creates list of users with given input array
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiCreateUsersWithArrayInputRequest
+	CreateUsersWithArrayInput Creates list of users with given input array
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiCreateUsersWithArrayInputRequest
 	*/
 	CreateUsersWithArrayInput(ctx _context.Context) ApiCreateUsersWithArrayInputRequest
 
-	/*
-	 * CreateUsersWithArrayInputExecute executes the request
-	 */
+	// CreateUsersWithArrayInputExecute executes the request
 	CreateUsersWithArrayInputExecute(r ApiCreateUsersWithArrayInputRequest) (*_nethttp.Response, error)
 
 	/*
-	 * CreateUsersWithListInput Creates list of users with given input array
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiCreateUsersWithListInputRequest
+	CreateUsersWithListInput Creates list of users with given input array
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiCreateUsersWithListInputRequest
 	*/
 	CreateUsersWithListInput(ctx _context.Context) ApiCreateUsersWithListInputRequest
 
-	/*
-	 * CreateUsersWithListInputExecute executes the request
-	 */
+	// CreateUsersWithListInputExecute executes the request
 	CreateUsersWithListInputExecute(r ApiCreateUsersWithListInputRequest) (*_nethttp.Response, error)
 
 	/*
-	 * DeleteUser Delete user
-	 * This can only be done by the logged in user.
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @param username The name that needs to be deleted
-	 * @return ApiDeleteUserRequest
+	DeleteUser Delete user
+
+	This can only be done by the logged in user.
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @param username The name that needs to be deleted
+	 @return ApiDeleteUserRequest
 	*/
 	DeleteUser(ctx _context.Context, username string) ApiDeleteUserRequest
 
-	/*
-	 * DeleteUserExecute executes the request
-	 */
+	// DeleteUserExecute executes the request
 	DeleteUserExecute(r ApiDeleteUserRequest) (*_nethttp.Response, error)
 
 	/*
-	 * GetUserByName Get user by user name
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @param username The name that needs to be fetched. Use user1 for testing.
-	 * @return ApiGetUserByNameRequest
+	GetUserByName Get user by user name
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @param username The name that needs to be fetched. Use user1 for testing.
+	 @return ApiGetUserByNameRequest
 	*/
 	GetUserByName(ctx _context.Context, username string) ApiGetUserByNameRequest
 
-	/*
-	 * GetUserByNameExecute executes the request
-	 * @return User
-	 */
+	// GetUserByNameExecute executes the request
+	//  @return User
 	GetUserByNameExecute(r ApiGetUserByNameRequest) (User, *_nethttp.Response, error)
 
 	/*
-	 * LoginUser Logs user into the system
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiLoginUserRequest
+	LoginUser Logs user into the system
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiLoginUserRequest
 	*/
 	LoginUser(ctx _context.Context) ApiLoginUserRequest
 
-	/*
-	 * LoginUserExecute executes the request
-	 * @return string
-	 */
+	// LoginUserExecute executes the request
+	//  @return string
 	LoginUserExecute(r ApiLoginUserRequest) (string, *_nethttp.Response, error)
 
 	/*
-	 * LogoutUser Logs out current logged in user session
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @return ApiLogoutUserRequest
+	LogoutUser Logs out current logged in user session
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @return ApiLogoutUserRequest
 	*/
 	LogoutUser(ctx _context.Context) ApiLogoutUserRequest
 
-	/*
-	 * LogoutUserExecute executes the request
-	 */
+	// LogoutUserExecute executes the request
 	LogoutUserExecute(r ApiLogoutUserRequest) (*_nethttp.Response, error)
 
 	/*
-	 * UpdateUser Updated user
-	 * This can only be done by the logged in user.
-	 * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
-	 * @param username name that need to be deleted
-	 * @return ApiUpdateUserRequest
+	UpdateUser Updated user
+
+	This can only be done by the logged in user.
+
+	 @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+	 @param username name that need to be deleted
+	 @return ApiUpdateUserRequest
 	*/
 	UpdateUser(ctx _context.Context, username string) ApiUpdateUserRequest
 
-	/*
-	 * UpdateUserExecute executes the request
-	 */
+	// UpdateUserExecute executes the request
 	UpdateUserExecute(r ApiUpdateUserRequest) (*_nethttp.Response, error)
 }
 
@@ -140,6 +135,7 @@ type ApiCreateUserRequest struct {
 	user *User
 }
 
+// Created user object
 func (r ApiCreateUserRequest) User(user User) ApiCreateUserRequest {
 	r.user = &user
 	return r
@@ -150,11 +146,13 @@ func (r ApiCreateUserRequest) Execute() (*_nethttp.Response, error) {
 }
 
 /*
- * CreateUser Create user
- * This can only be done by the logged in user.
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiCreateUserRequest
- */
+CreateUser Create user
+
+This can only be done by the logged in user.
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiCreateUserRequest
+*/
 func (a *UserApiService) CreateUser(ctx _context.Context) ApiCreateUserRequest {
 	return ApiCreateUserRequest{
 		ApiService: a,
@@ -162,9 +160,7 @@ func (a *UserApiService) CreateUser(ctx _context.Context) ApiCreateUserRequest {
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *UserApiService) CreateUserExecute(r ApiCreateUserRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPost
@@ -241,6 +237,7 @@ type ApiCreateUsersWithArrayInputRequest struct {
 	user *[]User
 }
 
+// List of user object
 func (r ApiCreateUsersWithArrayInputRequest) User(user []User) ApiCreateUsersWithArrayInputRequest {
 	r.user = &user
 	return r
@@ -251,10 +248,11 @@ func (r ApiCreateUsersWithArrayInputRequest) Execute() (*_nethttp.Response, erro
 }
 
 /*
- * CreateUsersWithArrayInput Creates list of users with given input array
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiCreateUsersWithArrayInputRequest
- */
+CreateUsersWithArrayInput Creates list of users with given input array
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiCreateUsersWithArrayInputRequest
+*/
 func (a *UserApiService) CreateUsersWithArrayInput(ctx _context.Context) ApiCreateUsersWithArrayInputRequest {
 	return ApiCreateUsersWithArrayInputRequest{
 		ApiService: a,
@@ -262,9 +260,7 @@ func (a *UserApiService) CreateUsersWithArrayInput(ctx _context.Context) ApiCrea
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *UserApiService) CreateUsersWithArrayInputExecute(r ApiCreateUsersWithArrayInputRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPost
@@ -341,6 +337,7 @@ type ApiCreateUsersWithListInputRequest struct {
 	user *[]User
 }
 
+// List of user object
 func (r ApiCreateUsersWithListInputRequest) User(user []User) ApiCreateUsersWithListInputRequest {
 	r.user = &user
 	return r
@@ -351,10 +348,11 @@ func (r ApiCreateUsersWithListInputRequest) Execute() (*_nethttp.Response, error
 }
 
 /*
- * CreateUsersWithListInput Creates list of users with given input array
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiCreateUsersWithListInputRequest
- */
+CreateUsersWithListInput Creates list of users with given input array
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiCreateUsersWithListInputRequest
+*/
 func (a *UserApiService) CreateUsersWithListInput(ctx _context.Context) ApiCreateUsersWithListInputRequest {
 	return ApiCreateUsersWithListInputRequest{
 		ApiService: a,
@@ -362,9 +360,7 @@ func (a *UserApiService) CreateUsersWithListInput(ctx _context.Context) ApiCreat
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *UserApiService) CreateUsersWithListInputExecute(r ApiCreateUsersWithListInputRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPost
@@ -447,12 +443,14 @@ func (r ApiDeleteUserRequest) Execute() (*_nethttp.Response, error) {
 }
 
 /*
- * DeleteUser Delete user
- * This can only be done by the logged in user.
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @param username The name that needs to be deleted
- * @return ApiDeleteUserRequest
- */
+DeleteUser Delete user
+
+This can only be done by the logged in user.
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @param username The name that needs to be deleted
+ @return ApiDeleteUserRequest
+*/
 func (a *UserApiService) DeleteUser(ctx _context.Context, username string) ApiDeleteUserRequest {
 	return ApiDeleteUserRequest{
 		ApiService: a,
@@ -461,9 +459,7 @@ func (a *UserApiService) DeleteUser(ctx _context.Context, username string) ApiDe
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *UserApiService) DeleteUserExecute(r ApiDeleteUserRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodDelete
@@ -542,11 +538,12 @@ func (r ApiGetUserByNameRequest) Execute() (User, *_nethttp.Response, error) {
 }
 
 /*
- * GetUserByName Get user by user name
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @param username The name that needs to be fetched. Use user1 for testing.
- * @return ApiGetUserByNameRequest
- */
+GetUserByName Get user by user name
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @param username The name that needs to be fetched. Use user1 for testing.
+ @return ApiGetUserByNameRequest
+*/
 func (a *UserApiService) GetUserByName(ctx _context.Context, username string) ApiGetUserByNameRequest {
 	return ApiGetUserByNameRequest{
 		ApiService: a,
@@ -555,10 +552,8 @@ func (a *UserApiService) GetUserByName(ctx _context.Context, username string) Ap
 	}
 }
 
-/*
- * Execute executes the request
- * @return User
- */
+// Execute executes the request
+//  @return User
 func (a *UserApiService) GetUserByNameExecute(r ApiGetUserByNameRequest) (User, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodGet
@@ -642,10 +637,12 @@ type ApiLoginUserRequest struct {
 	password *string
 }
 
+// The user name for login
 func (r ApiLoginUserRequest) Username(username string) ApiLoginUserRequest {
 	r.username = &username
 	return r
 }
+// The password for login in clear text
 func (r ApiLoginUserRequest) Password(password string) ApiLoginUserRequest {
 	r.password = &password
 	return r
@@ -656,10 +653,11 @@ func (r ApiLoginUserRequest) Execute() (string, *_nethttp.Response, error) {
 }
 
 /*
- * LoginUser Logs user into the system
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiLoginUserRequest
- */
+LoginUser Logs user into the system
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiLoginUserRequest
+*/
 func (a *UserApiService) LoginUser(ctx _context.Context) ApiLoginUserRequest {
 	return ApiLoginUserRequest{
 		ApiService: a,
@@ -667,10 +665,8 @@ func (a *UserApiService) LoginUser(ctx _context.Context) ApiLoginUserRequest {
 	}
 }
 
-/*
- * Execute executes the request
- * @return string
- */
+// Execute executes the request
+//  @return string
 func (a *UserApiService) LoginUserExecute(r ApiLoginUserRequest) (string, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodGet
@@ -765,10 +761,11 @@ func (r ApiLogoutUserRequest) Execute() (*_nethttp.Response, error) {
 }
 
 /*
- * LogoutUser Logs out current logged in user session
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @return ApiLogoutUserRequest
- */
+LogoutUser Logs out current logged in user session
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @return ApiLogoutUserRequest
+*/
 func (a *UserApiService) LogoutUser(ctx _context.Context) ApiLogoutUserRequest {
 	return ApiLogoutUserRequest{
 		ApiService: a,
@@ -776,9 +773,7 @@ func (a *UserApiService) LogoutUser(ctx _context.Context) ApiLogoutUserRequest {
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *UserApiService) LogoutUserExecute(r ApiLogoutUserRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodGet
@@ -851,6 +846,7 @@ type ApiUpdateUserRequest struct {
 	user *User
 }
 
+// Updated user object
 func (r ApiUpdateUserRequest) User(user User) ApiUpdateUserRequest {
 	r.user = &user
 	return r
@@ -861,12 +857,14 @@ func (r ApiUpdateUserRequest) Execute() (*_nethttp.Response, error) {
 }
 
 /*
- * UpdateUser Updated user
- * This can only be done by the logged in user.
- * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- * @param username name that need to be deleted
- * @return ApiUpdateUserRequest
- */
+UpdateUser Updated user
+
+This can only be done by the logged in user.
+
+ @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+ @param username name that need to be deleted
+ @return ApiUpdateUserRequest
+*/
 func (a *UserApiService) UpdateUser(ctx _context.Context, username string) ApiUpdateUserRequest {
 	return ApiUpdateUserRequest{
 		ApiService: a,
@@ -875,9 +873,7 @@ func (a *UserApiService) UpdateUser(ctx _context.Context, username string) ApiUp
 	}
 }
 
-/*
- * Execute executes the request
- */
+// Execute executes the request
 func (a *UserApiService) UpdateUserExecute(r ApiUpdateUserRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod   = _nethttp.MethodPut

samples/openapi3/client/petstore/go/go-petstore/client.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/openapi3/client/petstore/go/go-petstore/configuration.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/openapi3/client/petstore/go/go-petstore/model_200_response.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
 

samples/openapi3/client/petstore/go/go-petstore/model__special_model_name_.go

@@ -1,10 +1,10 @@
 /*
- * OpenAPI Petstore
- *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
- *
- * API version: 1.0.0
- */
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+API version: 1.0.0
+*/
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.