Add an optional spec version parameter to serialize method to write out version-specific properties

MaggieKimani1 · MaggieKimani1 · commit 312abb088e45 · 2023-01-23T16:03:17.000+03:00
diff --git a/src/Microsoft.OpenApi/Extensions/OpenApiSerializableExtensions.cs b/src/Microsoft.OpenApi/Extensions/OpenApiSerializableExtensions.cs
@@ -117,6 +117,10 @@ public static void Serialize<T>(this T element, IOpenApiWriter writer, OpenApiSp
 
             switch (specVersion)
             {
+                case OpenApiSpecVersion.OpenApi3_1:
+                    element.SerializeAsV3(writer, OpenApiSpecVersion.OpenApi3_1);
+                    break;
+                    
                 case OpenApiSpecVersion.OpenApi3_0:
                     element.SerializeAsV3(writer);
                     break;
diff --git a/src/Microsoft.OpenApi/Interfaces/IOpenApiSerializable.cs b/src/Microsoft.OpenApi/Interfaces/IOpenApiSerializable.cs
@@ -14,7 +14,8 @@ public interface IOpenApiSerializable : IOpenApiElement
         /// Serialize Open API element to v3.0.
         /// </summary>
         /// <param name="writer">The writer.</param>
-        void SerializeAsV3(IOpenApiWriter writer);
+        /// <param name="specVersion">The OpenApi specification version.</param>
+        void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion specVersion = OpenApiSpecVersion.OpenApi3_0);
 
         /// <summary>
         /// Serialize Open API element to v2.0.
diff --git a/src/Microsoft.OpenApi/Models/OpenApiCallback.cs b/src/Microsoft.OpenApi/Models/OpenApiCallback.cs
@@ -79,7 +79,7 @@ public void AddPathItem(RuntimeExpression expression, OpenApiPathItem pathItem)
         /// <summary>
         /// Serialize <see cref="OpenApiCallback"/> to Open Api v3.0
         /// </summary>
-        public void SerializeAsV3(IOpenApiWriter writer)
+        public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)
         {
             if (writer == null)
             {
diff --git a/src/Microsoft.OpenApi/Models/OpenApiComponents.cs b/src/Microsoft.OpenApi/Models/OpenApiComponents.cs
@@ -97,7 +97,7 @@ public OpenApiComponents(OpenApiComponents components)
         /// <summary>
         /// Serialize <see cref="OpenApiComponents"/> to Open Api v3.0.
         /// </summary>
-        public void SerializeAsV3(IOpenApiWriter writer)
+        public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)
         {
             if (writer == null)
             {
@@ -293,8 +293,10 @@ public void SerializeAsV3(IOpenApiWriter writer)
                     }
                 });
             
-            // pathItems
-            writer.WriteOptionalMap(
+            // pathItems - only present in v3.1
+            if(version == OpenApiSpecVersion.OpenApi3_1)
+            {
+                writer.WriteOptionalMap(
                 OpenApiConstants.PathItems,
                 PathItems,
                 (w, key, component) =>
@@ -310,9 +312,10 @@ public void SerializeAsV3(IOpenApiWriter writer)
                         component.SerializeAsV3(w);
                     }
                 });
-            
+            }
+
             // extensions
-            writer.WriteExtensions(Extensions, OpenApiSpecVersion.OpenApi3_0);
+            writer.WriteExtensions(Extensions, version);
 
             writer.WriteEndObject();
         }
diff --git a/src/Microsoft.OpenApi/Models/OpenApiContact.cs b/src/Microsoft.OpenApi/Models/OpenApiContact.cs
@@ -54,11 +54,11 @@ public OpenApiContact(OpenApiContact contact)
         /// <summary>
         /// Serialize <see cref="OpenApiContact"/> to Open Api v3.0
         /// </summary>
-        public void SerializeAsV3(IOpenApiWriter writer)
+        public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)
         {
-            WriteInternal(writer, OpenApiSpecVersion.OpenApi3_0);
+            WriteInternal(writer, version);
         }
-
+        
         /// <summary>
         /// Serialize <see cref="OpenApiContact"/> to Open Api v2.0
         /// </summary>
diff --git a/src/Microsoft.OpenApi/Models/OpenApiDiscriminator.cs b/src/Microsoft.OpenApi/Models/OpenApiDiscriminator.cs
@@ -39,7 +39,7 @@ public OpenApiDiscriminator(OpenApiDiscriminator discriminator)
         /// <summary>
         /// Serialize <see cref="OpenApiDiscriminator"/> to Open Api v3.0
         /// </summary>
-        public void SerializeAsV3(IOpenApiWriter writer)
+        public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)
         {
             if (writer == null)
             {
diff --git a/src/Microsoft.OpenApi/Models/OpenApiEncoding.cs b/src/Microsoft.OpenApi/Models/OpenApiEncoding.cs
@@ -74,7 +74,7 @@ public OpenApiEncoding(OpenApiEncoding encoding)
         /// <summary>
         /// Serialize <see cref="OpenApiExternalDocs"/> to Open Api v3.0.
         /// </summary>
-        public void SerializeAsV3(IOpenApiWriter writer)
+        public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)
         {
             if (writer == null)
             {
@@ -99,7 +99,7 @@ public void SerializeAsV3(IOpenApiWriter writer)
             writer.WriteProperty(OpenApiConstants.AllowReserved, AllowReserved, false);
 
             // extensions
-            writer.WriteExtensions(Extensions, OpenApiSpecVersion.OpenApi3_0);
+            writer.WriteExtensions(Extensions, version);
 
             writer.WriteEndObject();
         }
diff --git a/src/Microsoft.OpenApi/Models/OpenApiExample.cs b/src/Microsoft.OpenApi/Models/OpenApiExample.cs
@@ -76,7 +76,7 @@ public OpenApiExample(OpenApiExample example)
         /// <summary>
         /// Serialize <see cref="OpenApiExample"/> to Open Api v3.0
         /// </summary>
-        public void SerializeAsV3(IOpenApiWriter writer)
+        public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)
         {
             if (writer == null)
             {
diff --git a/src/Microsoft.OpenApi/Models/OpenApiExtensibleDictionary.cs b/src/Microsoft.OpenApi/Models/OpenApiExtensibleDictionary.cs
@@ -41,7 +41,7 @@ protected OpenApiExtensibleDictionary(
         /// <summary>
         /// Serialize to Open Api v3.0
         /// </summary>
-        public void SerializeAsV3(IOpenApiWriter writer)
+        public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)
         {
             if (writer == null)
             {
@@ -55,7 +55,7 @@ public void SerializeAsV3(IOpenApiWriter writer)
                 writer.WriteRequiredObject(item.Key, item.Value, (w, p) => p.SerializeAsV3(w));
             }
 
-            writer.WriteExtensions(Extensions, OpenApiSpecVersion.OpenApi3_0);
+            writer.WriteExtensions(Extensions, version);
 
             writer.WriteEndObject();
         }
diff --git a/src/Microsoft.OpenApi/Models/OpenApiExternalDocs.cs b/src/Microsoft.OpenApi/Models/OpenApiExternalDocs.cs
@@ -47,11 +47,11 @@ public OpenApiExternalDocs(OpenApiExternalDocs externalDocs)
         /// <summary>
         /// Serialize <see cref="OpenApiExternalDocs"/> to Open Api v3.0.
         /// </summary>
-        public void SerializeAsV3(IOpenApiWriter writer)
+        public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)
         {
-            WriteInternal(writer, OpenApiSpecVersion.OpenApi3_0);
+            WriteInternal(writer, version);
         }
-
+        
         /// <summary>
         /// Serialize <see cref="OpenApiExternalDocs"/> to Open Api v2.0.
         /// </summary>
diff --git a/src/Microsoft.OpenApi/Models/OpenApiHeader.cs b/src/Microsoft.OpenApi/Models/OpenApiHeader.cs
@@ -115,7 +115,7 @@ public OpenApiHeader(OpenApiHeader header)
         /// <summary>
         /// Serialize <see cref="OpenApiHeader"/> to Open Api v3.0
         /// </summary>
-        public void SerializeAsV3(IOpenApiWriter writer)
+        public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)
         {
             if (writer == null)
             {
diff --git a/src/Microsoft.OpenApi/Models/OpenApiInfo.cs b/src/Microsoft.OpenApi/Models/OpenApiInfo.cs
@@ -76,7 +76,7 @@ public OpenApiInfo(OpenApiInfo info)
         /// <summary>
         /// Serialize <see cref="OpenApiInfo"/> to Open Api v3.0
         /// </summary>
-        public void SerializeAsV3(IOpenApiWriter writer)
+        public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)
         {
             if (writer == null)
             {
@@ -88,9 +88,12 @@ public void SerializeAsV3(IOpenApiWriter writer)
             // title
             writer.WriteProperty(OpenApiConstants.Title, Title);
 
-            // summary
-            writer.WriteProperty(OpenApiConstants.Summary, Summary);
-            
+            // summary - present in 3.1
+            if (version == OpenApiSpecVersion.OpenApi3_1)
+            {
+                writer.WriteProperty(OpenApiConstants.Summary, Summary);
+            }
+           
             // description
             writer.WriteProperty(OpenApiConstants.Description, Description);
 
diff --git a/src/Microsoft.OpenApi/Models/OpenApiLicense.cs b/src/Microsoft.OpenApi/Models/OpenApiLicense.cs
@@ -53,9 +53,9 @@ public OpenApiLicense(OpenApiLicense license)
         /// <summary>
         /// Serialize <see cref="OpenApiLicense"/> to Open Api v3.0
         /// </summary>
-        public void SerializeAsV3(IOpenApiWriter writer)
+        public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)
         {
-            WriteInternal(writer, OpenApiSpecVersion.OpenApi3_0);
+            WriteInternal(writer, version);
         }
 
         /// <summary>
@@ -78,8 +78,11 @@ private void WriteInternal(IOpenApiWriter writer, OpenApiSpecVersion specVersion
             // name
             writer.WriteProperty(OpenApiConstants.Name, Name);
 
-            // identifier
-            writer.WriteProperty(OpenApiConstants.Identifier, Identifier);
+            // identifier - present in v3.1
+            if (specVersion == OpenApiSpecVersion.OpenApi3_1)
+            {
+                writer.WriteProperty(OpenApiConstants.Identifier, Identifier);
+            }
 
             // url
             writer.WriteProperty(OpenApiConstants.Url, Url?.OriginalString);
diff --git a/src/Microsoft.OpenApi/Models/OpenApiLink.cs b/src/Microsoft.OpenApi/Models/OpenApiLink.cs
@@ -85,7 +85,7 @@ public OpenApiLink(OpenApiLink link)
         /// <summary>
         /// Serialize <see cref="OpenApiLink"/> to Open Api v3.0
         /// </summary>
-        public void SerializeAsV3(IOpenApiWriter writer)
+        public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)
         {
             if (writer == null)
             {
diff --git a/src/Microsoft.OpenApi/Models/OpenApiMediaType.cs b/src/Microsoft.OpenApi/Models/OpenApiMediaType.cs
@@ -63,7 +63,7 @@ public OpenApiMediaType(OpenApiMediaType mediaType)
         /// <summary>
         /// Serialize <see cref="OpenApiMediaType"/> to Open Api v3.0.
         /// </summary>
-        public void SerializeAsV3(IOpenApiWriter writer)
+        public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)
         {
             if (writer == null)
             {
@@ -85,7 +85,7 @@ public void SerializeAsV3(IOpenApiWriter writer)
             writer.WriteOptionalMap(OpenApiConstants.Encoding, Encoding, (w, e) => e.SerializeAsV3(w));
 
             // extensions
-            writer.WriteExtensions(Extensions, OpenApiSpecVersion.OpenApi3_0);
+            writer.WriteExtensions(Extensions, version);
 
             writer.WriteEndObject();
         }
diff --git a/src/Microsoft.OpenApi/Models/OpenApiOAuthFlow.cs b/src/Microsoft.OpenApi/Models/OpenApiOAuthFlow.cs
@@ -61,7 +61,7 @@ public OpenApiOAuthFlow(OpenApiOAuthFlow oAuthFlow)
         /// <summary>
         /// Serialize <see cref="OpenApiOAuthFlow"/> to Open Api v3.0
         /// </summary>
-        public void SerializeAsV3(IOpenApiWriter writer)
+        public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)
         {
             if (writer == null)
             {
@@ -83,7 +83,7 @@ public void SerializeAsV3(IOpenApiWriter writer)
             writer.WriteRequiredMap(OpenApiConstants.Scopes, Scopes, (w, s) => w.WriteValue(s));
 
             // extensions
-            writer.WriteExtensions(Extensions, OpenApiSpecVersion.OpenApi3_0);
+            writer.WriteExtensions(Extensions, version);
 
             writer.WriteEndObject();
         }
diff --git a/src/Microsoft.OpenApi/Models/OpenApiOAuthFlows.cs b/src/Microsoft.OpenApi/Models/OpenApiOAuthFlows.cs
@@ -59,7 +59,7 @@ public OpenApiOAuthFlows(OpenApiOAuthFlows oAuthFlows)
         /// <summary>
         /// Serialize <see cref="OpenApiOAuthFlows"/> to Open Api v3.0
         /// </summary>
-        public void SerializeAsV3(IOpenApiWriter writer)
+        public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)
         {
             if (writer == null)
             {
@@ -87,7 +87,7 @@ public void SerializeAsV3(IOpenApiWriter writer)
                 (w, o) => o.SerializeAsV3(w));
 
             // extensions
-            writer.WriteExtensions(Extensions, OpenApiSpecVersion.OpenApi3_0);
+            writer.WriteExtensions(Extensions, version);
 
             writer.WriteEndObject();
         }
diff --git a/src/Microsoft.OpenApi/Models/OpenApiOperation.cs b/src/Microsoft.OpenApi/Models/OpenApiOperation.cs
@@ -134,7 +134,7 @@ public OpenApiOperation(OpenApiOperation operation)
         /// <summary>
         /// Serialize <see cref="OpenApiOperation"/> to Open Api v3.0.
         /// </summary>
-        public void SerializeAsV3(IOpenApiWriter writer)
+        public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)
         {
             if (writer == null)
             {
@@ -186,8 +186,8 @@ public void SerializeAsV3(IOpenApiWriter writer)
             writer.WriteOptionalCollection(OpenApiConstants.Servers, Servers, (w, s) => s.SerializeAsV3(w));
 
             // specification extensions
-            writer.WriteExtensions(Extensions, OpenApiSpecVersion.OpenApi3_0);
-
+            writer.WriteExtensions(Extensions, version);
+            
             writer.WriteEndObject();
         }
 
diff --git a/src/Microsoft.OpenApi/Models/OpenApiParameter.cs b/src/Microsoft.OpenApi/Models/OpenApiParameter.cs
@@ -172,7 +172,7 @@ public OpenApiParameter(OpenApiParameter parameter)
         /// <summary>
         /// Serialize <see cref="OpenApiParameter"/> to Open Api v3.0
         /// </summary>
-        public void SerializeAsV3(IOpenApiWriter writer)
+        public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)
         {
             if (writer == null)
             {
diff --git a/src/Microsoft.OpenApi/Models/OpenApiPathItem.cs b/src/Microsoft.OpenApi/Models/OpenApiPathItem.cs
@@ -88,7 +88,7 @@ public OpenApiPathItem(OpenApiPathItem pathItem)
         /// <summary>
         /// Serialize <see cref="OpenApiPathItem"/> to Open Api v3.0
         /// </summary>
-        public void SerializeAsV3(IOpenApiWriter writer)
+        public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)
         {
             if (writer == null)
             {
diff --git a/src/Microsoft.OpenApi/Models/OpenApiReference.cs b/src/Microsoft.OpenApi/Models/OpenApiReference.cs
@@ -146,7 +146,7 @@ public OpenApiReference(OpenApiReference reference)
         /// <summary>
         /// Serialize <see cref="OpenApiReference"/> to Open Api v3.0.
         /// </summary>
-        public void SerializeAsV3(IOpenApiWriter writer)
+        public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)
         {
             if (writer == null)
             {
@@ -169,11 +169,11 @@ public void SerializeAsV3(IOpenApiWriter writer)
 
             writer.WriteStartObject();
             
-            // summary
-            writer.WriteProperty(OpenApiConstants.Summary, Summary);
-            
-            // description
-            writer.WriteProperty(OpenApiConstants.Description, Description);
+            if (version == OpenApiSpecVersion.OpenApi3_1)
+            {
+                writer.WriteProperty(OpenApiConstants.Summary, Summary);
+                writer.WriteProperty(OpenApiConstants.Description, Description);
+            }            
 
             // $ref
             writer.WriteProperty(OpenApiConstants.DollarRef, ReferenceV3);
diff --git a/src/Microsoft.OpenApi/Models/OpenApiRequestBody.cs b/src/Microsoft.OpenApi/Models/OpenApiRequestBody.cs
@@ -68,7 +68,7 @@ public OpenApiRequestBody(OpenApiRequestBody requestBody)
         /// <summary>
         /// Serialize <see cref="OpenApiRequestBody"/> to Open Api v3.0
         /// </summary>
-        public void SerializeAsV3(IOpenApiWriter writer)
+        public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)
         {
             if (writer == null)
             {
diff --git a/src/Microsoft.OpenApi/Models/OpenApiResponse.cs b/src/Microsoft.OpenApi/Models/OpenApiResponse.cs
@@ -73,7 +73,7 @@ public OpenApiResponse(OpenApiResponse response)
         /// <summary>
         /// Serialize <see cref="OpenApiResponse"/> to Open Api v3.0.
         /// </summary>
-        public void SerializeAsV3(IOpenApiWriter writer)
+        public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)
         {
             if (writer == null)
             {
diff --git a/src/Microsoft.OpenApi/Models/OpenApiSchema.cs b/src/Microsoft.OpenApi/Models/OpenApiSchema.cs
@@ -295,7 +295,7 @@ public OpenApiSchema(OpenApiSchema schema)
         /// <summary>
         /// Serialize <see cref="OpenApiSchema"/> to Open Api v3.0
         /// </summary>
-        public void SerializeAsV3(IOpenApiWriter writer)
+        public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)
         {
             if (writer == null)
             {
diff --git a/src/Microsoft.OpenApi/Models/OpenApiSecurityRequirement.cs b/src/Microsoft.OpenApi/Models/OpenApiSecurityRequirement.cs
@@ -31,7 +31,7 @@ public OpenApiSecurityRequirement()
         /// <summary>
         /// Serialize <see cref="OpenApiSecurityRequirement"/> to Open Api v3.0
         /// </summary>
-        public void SerializeAsV3(IOpenApiWriter writer)
+        public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)
         {
             if (writer == null)
             {
diff --git a/src/Microsoft.OpenApi/Models/OpenApiSecurityScheme.cs b/src/Microsoft.OpenApi/Models/OpenApiSecurityScheme.cs
@@ -100,7 +100,7 @@ public OpenApiSecurityScheme(OpenApiSecurityScheme securityScheme)
         /// <summary>
         /// Serialize <see cref="OpenApiSecurityScheme"/> to Open Api v3.0
         /// </summary>
-        public void SerializeAsV3(IOpenApiWriter writer)
+        public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)
         {
             if (writer == null)
             {
diff --git a/src/Microsoft.OpenApi/Models/OpenApiServer.cs b/src/Microsoft.OpenApi/Models/OpenApiServer.cs
@@ -55,7 +55,7 @@ public OpenApiServer(OpenApiServer server)
         /// <summary>
         /// Serialize <see cref="OpenApiServer"/> to Open Api v3.0
         /// </summary>
-        public void SerializeAsV3(IOpenApiWriter writer)
+        public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)
         {
             if (writer == null)
             {
@@ -74,7 +74,7 @@ public void SerializeAsV3(IOpenApiWriter writer)
             writer.WriteOptionalMap(OpenApiConstants.Variables, Variables, (w, v) => v.SerializeAsV3(w));
 
             // specification extensions
-            writer.WriteExtensions(Extensions, OpenApiSpecVersion.OpenApi3_0);
+            writer.WriteExtensions(Extensions, version);
 
             writer.WriteEndObject();
         }
diff --git a/src/Microsoft.OpenApi/Models/OpenApiServerVariable.cs b/src/Microsoft.OpenApi/Models/OpenApiServerVariable.cs
diff --git a/src/Microsoft.OpenApi/Models/OpenApiTag.cs b/src/Microsoft.OpenApi/Models/OpenApiTag.cs
diff --git a/src/Microsoft.OpenApi/Models/OpenApiXml.cs b/src/Microsoft.OpenApi/Models/OpenApiXml.cs
diff --git a/src/Microsoft.OpenApi/OpenApiSpecVersion.cs b/src/Microsoft.OpenApi/OpenApiSpecVersion.cs

Original file line number	Diff line number	Diff line change
`@@ -79,7 +79,7 @@ public void AddPathItem(RuntimeExpression expression, OpenApiPathItem pathItem)`
`79`	`79`	`/// <summary>`
`80`	`80`	`/// Serialize <see cref="OpenApiCallback"/> to Open Api v3.0`
`81`	`81`	`/// </summary>`
`82`		`- public void SerializeAsV3(IOpenApiWriter writer)`
	`82`	`+ public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)`
`83`	`83`	`{`
`84`	`84`	`if (writer == null)`
`85`	`85`	`{`
Original file line number	Diff line number	Diff line change
`@@ -39,7 +39,7 @@ public OpenApiDiscriminator(OpenApiDiscriminator discriminator)`
`39`	`39`	`/// <summary>`
`40`	`40`	`/// Serialize <see cref="OpenApiDiscriminator"/> to Open Api v3.0`
`41`	`41`	`/// </summary>`
`42`		`- public void SerializeAsV3(IOpenApiWriter writer)`
	`42`	`+ public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)`
`43`	`43`	`{`
`44`	`44`	`if (writer == null)`
`45`	`45`	`{`
Original file line number	Diff line number	Diff line change
`@@ -74,7 +74,7 @@ public OpenApiEncoding(OpenApiEncoding encoding)`
`74`	`74`	`/// <summary>`
`75`	`75`	`/// Serialize <see cref="OpenApiExternalDocs"/> to Open Api v3.0.`
`76`	`76`	`/// </summary>`
`77`		`- public void SerializeAsV3(IOpenApiWriter writer)`
	`77`	`+ public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)`
`78`	`78`	`{`
`79`	`79`	`if (writer == null)`
`80`	`80`	`{`
`@@ -99,7 +99,7 @@ public void SerializeAsV3(IOpenApiWriter writer)`
`99`	`99`	`writer.WriteProperty(OpenApiConstants.AllowReserved, AllowReserved, false);`
`100`	`100`
`101`	`101`	`// extensions`
`102`		`- writer.WriteExtensions(Extensions, OpenApiSpecVersion.OpenApi3_0);`
	`102`	`+ writer.WriteExtensions(Extensions, version);`
`103`	`103`
`104`	`104`	`writer.WriteEndObject();`
`105`	`105`	`}`
Original file line number	Diff line number	Diff line change
`@@ -76,7 +76,7 @@ public OpenApiExample(OpenApiExample example)`
`76`	`76`	`/// <summary>`
`77`	`77`	`/// Serialize <see cref="OpenApiExample"/> to Open Api v3.0`
`78`	`78`	`/// </summary>`
`79`		`- public void SerializeAsV3(IOpenApiWriter writer)`
	`79`	`+ public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)`
`80`	`80`	`{`
`81`	`81`	`if (writer == null)`
`82`	`82`	`{`
Original file line number	Diff line number	Diff line change
`@@ -41,7 +41,7 @@ protected OpenApiExtensibleDictionary(`
`41`	`41`	`/// <summary>`
`42`	`42`	`/// Serialize to Open Api v3.0`
`43`	`43`	`/// </summary>`
`44`		`- public void SerializeAsV3(IOpenApiWriter writer)`
	`44`	`+ public void SerializeAsV3(IOpenApiWriter writer, OpenApiSpecVersion version = OpenApiSpecVersion.OpenApi3_0)`
`45`	`45`	`{`
`46`	`46`	`if (writer == null)`
`47`	`47`	`{`
`@@ -55,7 +55,7 @@ public void SerializeAsV3(IOpenApiWriter writer)`
`55`	`55`	`writer.WriteRequiredObject(item.Key, item.Value, (w, p) => p.SerializeAsV3(w));`
`56`	`56`	`}`
`57`	`57`
`58`		`- writer.WriteExtensions(Extensions, OpenApiSpecVersion.OpenApi3_0);`
	`58`	`+ writer.WriteExtensions(Extensions, version);`
`59`	`59`
`60`	`60`	`writer.WriteEndObject();`
`61`	`61`	`}`