add comments

lucashuet93 · lucashuet93 · commit db56beee0cbc · 2018-12-07T14:21:51.000-05:00
diff --git a/src/APIM_ARMTemplate/apimtemplate/Commands/Create.cs b/src/APIM_ARMTemplate/apimtemplate/Commands/Create.cs
@@ -17,7 +17,7 @@ public CreateCommand()
             // list command options
             CommandOption openAPISpecFile = this.Option("--openAPISpecFile <openAPISpecFile>", "Open API spec file location", CommandOptionType.SingleValue);
             CommandOption openAPISpecURL = this.Option("--openAPISpecURL <openAPISpecURL>", "Open API spec remote url", CommandOptionType.SingleValue);
-            CommandOption outputLocation = this.Option("--outputLocation <outputLocation>", "Template output location", CommandOptionType.SingleValue);
+            CommandOption outputLocation = this.Option("--outputLocation <outputLocation>", "Template output location", CommandOptionType.SingleValue).IsRequired();
             CommandOption xmlPolicyFile = this.Option("--xmlPolicyFile <xmlPolicyFile>", "XML policy file location", CommandOptionType.SingleValue);
             CommandOption xmlPolicyURL = this.Option("--xmlPolicyURL <xmlPolicyURL>", "XML policy remote url", CommandOptionType.SingleValue);
             CommandOption linked = this.Option("--linked <linked>", "Creates linked templates versus inlined into a single file", CommandOptionType.SingleValue);
@@ -34,9 +34,9 @@ public CreateCommand()
 
             this.OnExecute(async () =>
             {
+                // ensure required parameters have been passed in
                 if ((openAPISpecFile.HasValue() || openAPISpecURL.HasValue()) && outputLocation.HasValue())
                 {
-                    // required parameters have been passed in
                     // convert command options to CLIArguments class
                     CLICreatorArguments cliArguments = new CLICreatorArguments()
                     {
@@ -58,19 +58,21 @@ public CreateCommand()
 
                     if (apiVersionSet.HasValue() && AttemptAPIVersionSetConversion(cliArguments) != null)
                     {
-                        // unable to convert version set argument into object
+                        // unable to convert version set argument into object, would cause failure down the line
                         ColoredConsole.Error.WriteLine("Incorrect API Version Set object structure");
                         return 0;
                     }
                     else
                     {
+                        // required parameters have been supplied and versionSet has correct object structure
+                        
                         // initialize helper classes
                         OpenAPISpecReader openAPISpecReader = new OpenAPISpecReader();
                         ARMTemplateWriter armTemplateWriter = new ARMTemplateWriter();
                         APITemplateCreator apiTemplateCreator = new APITemplateCreator();
                         TagTemplateCreator tagTemplateCreator = new TagTemplateCreator();
 
-                        // create OpenApiDocument
+                        // create OpenApiDocument from Open API spec file
                         OpenApiDocument doc = new OpenApiDocument();
                         if (cliArguments.openAPISpecFile != null)
                         {
diff --git a/src/APIM_ARMTemplate/apimtemplate/FileHandlers/ARMTemplateWriter.cs b/src/APIM_ARMTemplate/apimtemplate/FileHandlers/ARMTemplateWriter.cs
@@ -24,6 +24,7 @@ public void WriteAPITemplateToFile(APITemplate template, string location)
 
         public void WriteTagTemplatesToFile(List<TagTemplate> tagTemplates, string location)
         {
+            // give each tag template a unique file name using count
             int templateNumber = 0;
             foreach(TagTemplate tagTemplate in tagTemplates)
             {
@@ -33,6 +34,7 @@ public void WriteTagTemplatesToFile(List<TagTemplate> tagTemplates, string locat
 
         public void WriteTagDescriptionTemplatesToFile(List<TagDescriptionTemplate> tagDescriptionTemplates, string location)
         {
+            // give each tag description template a unique file name using count
             int templateNumber = 0;
             foreach (TagDescriptionTemplate tagDescriptionTemplate in tagDescriptionTemplates)
             {
diff --git a/src/APIM_ARMTemplate/apimtemplate/TemplateCreators/APITemplateCreator.cs b/src/APIM_ARMTemplate/apimtemplate/TemplateCreators/APITemplateCreator.cs
@@ -93,6 +93,7 @@ public APITemplateOAuth2 CreateOAuth2(OpenApiSecurityScheme scheme)
                 authorizationServerId = "",
                 scope = ""
             };
+            // iterate through different flows, set serverId and scope once auth flow is found
             if (scheme.Flows.Implicit != null)
             {
                 oAuth2.authorizationServerId = scheme.Flows.Implicit.AuthorizationUrl != null ? scheme.Flows.Implicit.AuthorizationUrl.ToString() : "";
@@ -118,6 +119,7 @@ public APITemplateOAuth2 CreateOAuth2(OpenApiSecurityScheme scheme)
 
         public async Task<string> CreateOpenAPISpecContentsAsync(CLICreatorArguments cliArguments)
         {
+            // return contents of supplied Open API Spec file
             if (cliArguments.openAPISpecFile != null)
             {
                 return File.ReadAllText(cliArguments.openAPISpecFile);
@@ -144,6 +146,7 @@ public async Task<string> CreateOpenAPISpecContentsAsync(CLICreatorArguments cli
 
         public APITemplateSubscriptionKeyParameterNames CreateSubscriptionKeyParameterNames(OpenApiDocument doc)
         {
+            // subscription key parameter names are found in security requirements, organized by parameter location
             string header = "";
             string query = "";
             foreach (OpenApiSecurityRequirement requirement in doc.SecurityRequirements)
@@ -186,6 +189,7 @@ public bool IsSubscriptionRequired(OpenApiDocument doc)
 
         public string[] CreateProtocols(OpenApiDocument doc)
         {
+            // schemes from Open API spec are concatenated onto the host during OpenApiDocument conversion, each becoming a different Server object. Split the strings to pull the protocols
             List<string> protocols = new List<string>();
             foreach (OpenApiServer server in doc.Servers)
             {
diff --git a/src/APIM_ARMTemplate/apimtemplate/TemplateCreators/OperationTemplateCreator.cs b/src/APIM_ARMTemplate/apimtemplate/TemplateCreators/OperationTemplateCreator.cs
@@ -29,7 +29,6 @@ public List<OperationTemplate> CreateOperationTemplates(OpenApiDocument doc)
                             templateParameters = CreateTemplateParameters(operation.Value.Parameters).ToArray(),
                             responses = CreateOperationResponses(operation.Value.Responses).ToArray(),
                             request = CreateOperationRequest(operation.Value),
-
                             //unfinished
                             policies = null
                         }
@@ -46,7 +45,9 @@ public OperationTemplateRequest CreateOperationRequest(OpenApiOperation operatio
             OperationTemplateRequest request = new OperationTemplateRequest()
             {
                 description = operation.RequestBody != null ? operation.RequestBody.Description : null,
+                // request parameters with parameter location query
                 queryParameters = CreateTemplateParameters(operation.Parameters.Where(p => p.In == ParameterLocation.Query).ToList()).ToArray(),
+                // request parameters with parameter location header
                 headers = CreateTemplateParameters(operation.Parameters.Where(p => p.In == ParameterLocation.Header).ToList()).ToArray(),
                 representations = operation.RequestBody != null ? CreateRepresentations(operation.RequestBody.Content).ToArray() : null
             };
@@ -74,6 +75,7 @@ public List<OperationTemplateRepresentation> CreateRepresentations(IDictionary<s
             List<OperationTemplateRepresentation> representations = new List<OperationTemplateRepresentation>();
             foreach (KeyValuePair<string, OpenApiMediaType> pair in content)
             {
+                // use representation examples to create values and default value
                 OpenApiParameterHeaderIntersection param = new OpenApiParameterHeaderIntersection()
                 {
                     Example = pair.Value.Example,
@@ -123,6 +125,7 @@ public List<OperationTemplateParameter> CreateResponseHeaders(IDictionary<string
             List<OperationTemplateParameter> headers = new List<OperationTemplateParameter>();
             foreach (KeyValuePair<string, OpenApiHeader> pair in headerPairs)
             {
+                // use header examples to create values and default value
                 OpenApiParameterHeaderIntersection param = new OpenApiParameterHeaderIntersection()
                 {
                     Example = pair.Value.Example,
@@ -147,6 +150,7 @@ public List<OperationTemplateParameter> CreateTemplateParameters(IList<OpenApiPa
             List<OperationTemplateParameter> templateParameters = new List<OperationTemplateParameter>();
             foreach (OpenApiParameter parameter in parameters)
             {
+                // use parameter examples to create values and default value
                 OpenApiParameterHeaderIntersection param = new OpenApiParameterHeaderIntersection()
                 {
                     Example = parameter.Example,
@@ -171,11 +175,13 @@ public List<string> CreateParameterValues(OpenApiParameterHeaderIntersection par
             List<string> values = new List<string>();
             if (parameter.Example != null)
             {
+                // add example property to values
                 values.Add(JsonConvert.SerializeObject(parameter.Example));
 
             }
             foreach (KeyValuePair<string, OpenApiExample> example in parameter.Examples)
             {
+                // add each example in examples list property to values
                 values.Add(JsonConvert.SerializeObject(example.Value));
             }
             return values;
@@ -185,11 +191,13 @@ public string CreateParameterDefaultValue(OpenApiParameterHeaderIntersection par
         {
             if (parameter.Example != null)
             {
+                // use example property for default value if given
                 return JsonConvert.SerializeObject(parameter.Example);
 
             }
             else if (parameter.Examples != null)
             {
+                // use first example in examples list property for default value if example property is not given
                 return JsonConvert.SerializeObject(parameter.Examples.SingleOrDefault().Value);
             }
             else
@@ -199,11 +207,13 @@ public string CreateParameterDefaultValue(OpenApiParameterHeaderIntersection par
         }
     }
 
+    // used to create parameter values
     public class OpenApiParameterHeaderIntersection {
         public IOpenApiAny Example { get; set; }
         public IDictionary<string, OpenApiExample> Examples { get; set; }
     }
 
+    // used to give compiler known object structure in order to create form parameters
     public class OperationSchemaExample
     {
         public object Value { get; set; }
diff --git a/src/APIM_ARMTemplate/apimtemplate/TemplateCreators/SchemaTemplateCreator.cs b/src/APIM_ARMTemplate/apimtemplate/TemplateCreators/SchemaTemplateCreator.cs
@@ -11,6 +11,7 @@ public List<SchemaTemplate> CreateSchemaTemplates(OpenApiDocument doc)
             List<SchemaTemplate> schemaTemplates = new List<SchemaTemplate>();
             foreach (KeyValuePair<string, OpenApiSchema> definition in doc.Components.Schemas)
             {
+                // create a new schema template for each definition found in the spec
                 SchemaTemplate schema = new SchemaTemplate()
                 {
                     name = definition.Key,
diff --git a/src/APIM_ARMTemplate/apimtemplate/TemplateCreators/TagTemplateCreator.cs b/src/APIM_ARMTemplate/apimtemplate/TemplateCreators/TagTemplateCreator.cs
@@ -10,6 +10,7 @@ public List<TagTemplate> CreateTagTemplates(OpenApiDocument doc)
             List<TagTemplate> tagTemplates = new List<TagTemplate>();
             foreach (OpenApiTag tag in doc.Tags)
             {
+                // create a new tag template for each tag found in the spec
                 TagTemplate tagSchema = new TagTemplate()
                 {
                     name = tag.Name,
@@ -26,6 +27,7 @@ public List<TagDescriptionTemplate> CreateTagDescriptionTemplates(OpenApiDocumen
             List<TagDescriptionTemplate> tagDescriptionTemplates = new List<TagDescriptionTemplate>();
             foreach (OpenApiTag tag in doc.Tags)
             {
+                // create a new tag description template for each tag found in the spec
                 TagDescriptionTemplate tagDescriptionSchema = new TagDescriptionTemplate()
                 {
                     name = tag.Name,

Original file line number	Diff line number	Diff line change
`@@ -17,7 +17,7 @@ public CreateCommand()`
`17`	`17`	`// list command options`
`18`	`18`	`CommandOption openAPISpecFile = this.Option("--openAPISpecFile <openAPISpecFile>", "Open API spec file location", CommandOptionType.SingleValue);`
`19`	`19`	`CommandOption openAPISpecURL = this.Option("--openAPISpecURL <openAPISpecURL>", "Open API spec remote url", CommandOptionType.SingleValue);`
`20`		`- CommandOption outputLocation = this.Option("--outputLocation <outputLocation>", "Template output location", CommandOptionType.SingleValue);`
	`20`	`+ CommandOption outputLocation = this.Option("--outputLocation <outputLocation>", "Template output location", CommandOptionType.SingleValue).IsRequired();`
`21`	`21`	`CommandOption xmlPolicyFile = this.Option("--xmlPolicyFile <xmlPolicyFile>", "XML policy file location", CommandOptionType.SingleValue);`
`22`	`22`	`CommandOption xmlPolicyURL = this.Option("--xmlPolicyURL <xmlPolicyURL>", "XML policy remote url", CommandOptionType.SingleValue);`
`23`	`23`	`CommandOption linked = this.Option("--linked <linked>", "Creates linked templates versus inlined into a single file", CommandOptionType.SingleValue);`
`@@ -34,9 +34,9 @@ public CreateCommand()`
`34`	`34`
`35`	`35`	`this.OnExecute(async () =>`
`36`	`36`	`{`
	`37`	`+ // ensure required parameters have been passed in`
`37`	`38`	`if ((openAPISpecFile.HasValue() \|\| openAPISpecURL.HasValue()) && outputLocation.HasValue())`
`38`	`39`	`{`
`39`		`- // required parameters have been passed in`
`40`	`40`	`// convert command options to CLIArguments class`
`41`	`41`	`CLICreatorArguments cliArguments = new CLICreatorArguments()`
`42`	`42`	`{`
`@@ -58,19 +58,21 @@ public CreateCommand()`
`58`	`58`
`59`	`59`	`if (apiVersionSet.HasValue() && AttemptAPIVersionSetConversion(cliArguments) != null)`
`60`	`60`	`{`
`61`		`- // unable to convert version set argument into object`
	`61`	`+ // unable to convert version set argument into object, would cause failure down the line`
`62`	`62`	`ColoredConsole.Error.WriteLine("Incorrect API Version Set object structure");`
`63`	`63`	`return 0;`
`64`	`64`	`}`
`65`	`65`	`else`
`66`	`66`	`{`
	`67`	`+ // required parameters have been supplied and versionSet has correct object structure`
	`68`	`+`
`67`	`69`	`// initialize helper classes`
`68`	`70`	`OpenAPISpecReader openAPISpecReader = new OpenAPISpecReader();`
`69`	`71`	`ARMTemplateWriter armTemplateWriter = new ARMTemplateWriter();`
`70`	`72`	`APITemplateCreator apiTemplateCreator = new APITemplateCreator();`
`71`	`73`	`TagTemplateCreator tagTemplateCreator = new TagTemplateCreator();`
`72`	`74`
`73`		`- // create OpenApiDocument`
	`75`	`+ // create OpenApiDocument from Open API spec file`
`74`	`76`	`OpenApiDocument doc = new OpenApiDocument();`
`75`	`77`	`if (cliArguments.openAPISpecFile != null)`
`76`	`78`	`{`
Original file line number	Diff line number	Diff line change
`@@ -24,6 +24,7 @@ public void WriteAPITemplateToFile(APITemplate template, string location)`
`24`	`24`
`25`	`25`	`public void WriteTagTemplatesToFile(List<TagTemplate> tagTemplates, string location)`
`26`	`26`	`{`
	`27`	`+ // give each tag template a unique file name using count`
`27`	`28`	`int templateNumber = 0;`
`28`	`29`	`foreach(TagTemplate tagTemplate in tagTemplates)`
`29`	`30`	`{`
`@@ -33,6 +34,7 @@ public void WriteTagTemplatesToFile(List<TagTemplate> tagTemplates, string locat`
`33`	`34`
`34`	`35`	`public void WriteTagDescriptionTemplatesToFile(List<TagDescriptionTemplate> tagDescriptionTemplates, string location)`
`35`	`36`	`{`
	`37`	`+ // give each tag description template a unique file name using count`
`36`	`38`	`int templateNumber = 0;`
`37`	`39`	`foreach (TagDescriptionTemplate tagDescriptionTemplate in tagDescriptionTemplates)`
`38`	`40`	`{`
Original file line number	Diff line number	Diff line change
`@@ -93,6 +93,7 @@ public APITemplateOAuth2 CreateOAuth2(OpenApiSecurityScheme scheme)`
`93`	`93`	`authorizationServerId = "",`
`94`	`94`	`scope = ""`
`95`	`95`	`};`
	`96`	`+ // iterate through different flows, set serverId and scope once auth flow is found`
`96`	`97`	`if (scheme.Flows.Implicit != null)`
`97`	`98`	`{`
`98`	`99`	`oAuth2.authorizationServerId = scheme.Flows.Implicit.AuthorizationUrl != null ? scheme.Flows.Implicit.AuthorizationUrl.ToString() : "";`
`@@ -118,6 +119,7 @@ public APITemplateOAuth2 CreateOAuth2(OpenApiSecurityScheme scheme)`
`118`	`119`
`119`	`120`	`public async Task<string> CreateOpenAPISpecContentsAsync(CLICreatorArguments cliArguments)`
`120`	`121`	`{`
	`122`	`+ // return contents of supplied Open API Spec file`
`121`	`123`	`if (cliArguments.openAPISpecFile != null)`
`122`	`124`	`{`
`123`	`125`	`return File.ReadAllText(cliArguments.openAPISpecFile);`
`@@ -144,6 +146,7 @@ public async Task<string> CreateOpenAPISpecContentsAsync(CLICreatorArguments cli`
`144`	`146`
`145`	`147`	`public APITemplateSubscriptionKeyParameterNames CreateSubscriptionKeyParameterNames(OpenApiDocument doc)`
`146`	`148`	`{`
	`149`	`+ // subscription key parameter names are found in security requirements, organized by parameter location`
`147`	`150`	`string header = "";`
`148`	`151`	`string query = "";`
`149`	`152`	`foreach (OpenApiSecurityRequirement requirement in doc.SecurityRequirements)`
`@@ -186,6 +189,7 @@ public bool IsSubscriptionRequired(OpenApiDocument doc)`
`186`	`189`
`187`	`190`	`public string[] CreateProtocols(OpenApiDocument doc)`
`188`	`191`	`{`
	`192`	`+ // schemes from Open API spec are concatenated onto the host during OpenApiDocument conversion, each becoming a different Server object. Split the strings to pull the protocols`
`189`	`193`	`List<string> protocols = new List<string>();`
`190`	`194`	`foreach (OpenApiServer server in doc.Servers)`
`191`	`195`	`{`
Original file line number	Diff line number	Diff line change
`@@ -29,7 +29,6 @@ public List<OperationTemplate> CreateOperationTemplates(OpenApiDocument doc)`
`29`	`29`	`templateParameters = CreateTemplateParameters(operation.Value.Parameters).ToArray(),`
`30`	`30`	`responses = CreateOperationResponses(operation.Value.Responses).ToArray(),`
`31`	`31`	`request = CreateOperationRequest(operation.Value),`
`32`		`-`
`33`	`32`	`//unfinished`
`34`	`33`	`policies = null`
`35`	`34`	`}`
`@@ -46,7 +45,9 @@ public OperationTemplateRequest CreateOperationRequest(OpenApiOperation operatio`
`46`	`45`	`OperationTemplateRequest request = new OperationTemplateRequest()`
`47`	`46`	`{`
`48`	`47`	`description = operation.RequestBody != null ? operation.RequestBody.Description : null,`
	`48`	`+ // request parameters with parameter location query`
`49`	`49`	`queryParameters = CreateTemplateParameters(operation.Parameters.Where(p => p.In == ParameterLocation.Query).ToList()).ToArray(),`
	`50`	`+ // request parameters with parameter location header`
`50`	`51`	`headers = CreateTemplateParameters(operation.Parameters.Where(p => p.In == ParameterLocation.Header).ToList()).ToArray(),`
`51`	`52`	`representations = operation.RequestBody != null ? CreateRepresentations(operation.RequestBody.Content).ToArray() : null`
`52`	`53`	`};`
`@@ -74,6 +75,7 @@ public List<OperationTemplateRepresentation> CreateRepresentations(IDictionary<s`
`74`	`75`	`List<OperationTemplateRepresentation> representations = new List<OperationTemplateRepresentation>();`
`75`	`76`	`foreach (KeyValuePair<string, OpenApiMediaType> pair in content)`
`76`	`77`	`{`
	`78`	`+ // use representation examples to create values and default value`
`77`	`79`	`OpenApiParameterHeaderIntersection param = new OpenApiParameterHeaderIntersection()`
`78`	`80`	`{`
`79`	`81`	`Example = pair.Value.Example,`
`@@ -123,6 +125,7 @@ public List<OperationTemplateParameter> CreateResponseHeaders(IDictionary<string`
`123`	`125`	`List<OperationTemplateParameter> headers = new List<OperationTemplateParameter>();`
`124`	`126`	`foreach (KeyValuePair<string, OpenApiHeader> pair in headerPairs)`
`125`	`127`	`{`
	`128`	`+ // use header examples to create values and default value`
`126`	`129`	`OpenApiParameterHeaderIntersection param = new OpenApiParameterHeaderIntersection()`
`127`	`130`	`{`
`128`	`131`	`Example = pair.Value.Example,`
`@@ -147,6 +150,7 @@ public List<OperationTemplateParameter> CreateTemplateParameters(IList<OpenApiPa`
`147`	`150`	`List<OperationTemplateParameter> templateParameters = new List<OperationTemplateParameter>();`
`148`	`151`	`foreach (OpenApiParameter parameter in parameters)`
`149`	`152`	`{`
	`153`	`+ // use parameter examples to create values and default value`
`150`	`154`	`OpenApiParameterHeaderIntersection param = new OpenApiParameterHeaderIntersection()`
`151`	`155`	`{`
`152`	`156`	`Example = parameter.Example,`
`@@ -171,11 +175,13 @@ public List<string> CreateParameterValues(OpenApiParameterHeaderIntersection par`
`171`	`175`	`List<string> values = new List<string>();`
`172`	`176`	`if (parameter.Example != null)`
`173`	`177`	`{`
	`178`	`+ // add example property to values`
`174`	`179`	`values.Add(JsonConvert.SerializeObject(parameter.Example));`
`175`	`180`
`176`	`181`	`}`
`177`	`182`	`foreach (KeyValuePair<string, OpenApiExample> example in parameter.Examples)`
`178`	`183`	`{`
	`184`	`+ // add each example in examples list property to values`
`179`	`185`	`values.Add(JsonConvert.SerializeObject(example.Value));`
`180`	`186`	`}`
`181`	`187`	`return values;`
`@@ -185,11 +191,13 @@ public string CreateParameterDefaultValue(OpenApiParameterHeaderIntersection par`
`185`	`191`	`{`
`186`	`192`	`if (parameter.Example != null)`
`187`	`193`	`{`
	`194`	`+ // use example property for default value if given`
`188`	`195`	`return JsonConvert.SerializeObject(parameter.Example);`
`189`	`196`
`190`	`197`	`}`
`191`	`198`	`else if (parameter.Examples != null)`
`192`	`199`	`{`
	`200`	`+ // use first example in examples list property for default value if example property is not given`
`193`	`201`	`return JsonConvert.SerializeObject(parameter.Examples.SingleOrDefault().Value);`
`194`	`202`	`}`
`195`	`203`	`else`
`@@ -199,11 +207,13 @@ public string CreateParameterDefaultValue(OpenApiParameterHeaderIntersection par`
`199`	`207`	`}`
`200`	`208`	`}`
`201`	`209`
	`210`	`+ // used to create parameter values`
`202`	`211`	`public class OpenApiParameterHeaderIntersection {`
`203`	`212`	`public IOpenApiAny Example { get; set; }`
`204`	`213`	`public IDictionary<string, OpenApiExample> Examples { get; set; }`
`205`	`214`	`}`
`206`	`215`
	`216`	`+ // used to give compiler known object structure in order to create form parameters`
`207`	`217`	`public class OperationSchemaExample`
`208`	`218`	`{`
`209`	`219`	`public object Value { get; set; }`
Original file line number	Diff line number	Diff line change
`@@ -11,6 +11,7 @@ public List<SchemaTemplate> CreateSchemaTemplates(OpenApiDocument doc)`
`11`	`11`	`List<SchemaTemplate> schemaTemplates = new List<SchemaTemplate>();`
`12`	`12`	`foreach (KeyValuePair<string, OpenApiSchema> definition in doc.Components.Schemas)`
`13`	`13`	`{`
	`14`	`+ // create a new schema template for each definition found in the spec`
`14`	`15`	`SchemaTemplate schema = new SchemaTemplate()`
`15`	`16`	`{`
`16`	`17`	`name = definition.Key,`
Original file line number	Diff line number	Diff line change
`@@ -10,6 +10,7 @@ public List<TagTemplate> CreateTagTemplates(OpenApiDocument doc)`
`10`	`10`	`List<TagTemplate> tagTemplates = new List<TagTemplate>();`
`11`	`11`	`foreach (OpenApiTag tag in doc.Tags)`
`12`	`12`	`{`
	`13`	`+ // create a new tag template for each tag found in the spec`
`13`	`14`	`TagTemplate tagSchema = new TagTemplate()`
`14`	`15`	`{`
`15`	`16`	`name = tag.Name,`
`@@ -26,6 +27,7 @@ public List<TagDescriptionTemplate> CreateTagDescriptionTemplates(OpenApiDocumen`
`26`	`27`	`List<TagDescriptionTemplate> tagDescriptionTemplates = new List<TagDescriptionTemplate>();`
`27`	`28`	`foreach (OpenApiTag tag in doc.Tags)`
`28`	`29`	`{`
	`30`	`+ // create a new tag description template for each tag found in the spec`
`29`	`31`	`TagDescriptionTemplate tagDescriptionSchema = new TagDescriptionTemplate()`
`30`	`32`	`{`
`31`	`33`	`name = tag.Name,`