Update public API interface

Author: MaggieKimani1

test/Microsoft.OpenApi.Tests/PublicApi/PublicApi.approved.txt

@@ -166,6 +166,14 @@ namespace Microsoft.OpenApi.Extensions
         public const string Name = "extensions";
         public void Evaluate(Json.Schema.EvaluationContext context) { }
     }
+    [Json.Schema.SchemaKeyword("externalDocs")]
+    public class ExternalDocsKeyword : Json.Schema.IJsonSchemaKeyword
+    {
+        public const string Name = "externalDocs";
+        public ExternalDocsKeyword(Microsoft.OpenApi.Models.OpenApiExternalDocs value) { }
+        public Microsoft.OpenApi.Models.OpenApiExternalDocs Value { get; }
+        public void Evaluate(Json.Schema.EvaluationContext context) { }
+    }
     public static class JsonSchemaBuilderExtensions
     {
         public static Json.Schema.JsonSchemaBuilder AdditionalPropertiesAllowed(this Json.Schema.JsonSchemaBuilder builder, bool additionalPropertiesAllowed) { }
@@ -174,6 +182,8 @@ namespace Microsoft.OpenApi.Extensions
         public static Json.Schema.JsonSchemaBuilder ExclusiveMinimum(this Json.Schema.JsonSchemaBuilder builder, bool value) { }
         public static Json.Schema.JsonSchemaBuilder Extensions(this Json.Schema.JsonSchemaBuilder builder, System.Collections.Generic.IDictionary<string, Microsoft.OpenApi.Interfaces.IOpenApiExtension> extensions) { }
         public static Json.Schema.JsonSchemaBuilder Nullable(this Json.Schema.JsonSchemaBuilder builder, bool value) { }
+        public static Json.Schema.JsonSchemaBuilder OpenApiExternalDocs(this Json.Schema.JsonSchemaBuilder builder, Microsoft.OpenApi.Models.OpenApiExternalDocs externalDocs) { }
+        public static Json.Schema.JsonSchemaBuilder Remove(this Json.Schema.JsonSchemaBuilder builder, string keyword) { }
         public static Json.Schema.JsonSchemaBuilder Summary(this Json.Schema.JsonSchemaBuilder builder, string summary) { }
     }
     public static class JsonSchemaExtensions
@@ -184,6 +194,7 @@ namespace Microsoft.OpenApi.Extensions
         public static Microsoft.OpenApi.Extensions.DiscriminatorKeyword GetOpenApiDiscriminator(this Json.Schema.JsonSchema schema) { }
         public static bool? GetOpenApiExclusiveMaximum(this Json.Schema.JsonSchema schema) { }
         public static bool? GetOpenApiExclusiveMinimum(this Json.Schema.JsonSchema schema) { }
+        public static Microsoft.OpenApi.Models.OpenApiExternalDocs GetOpenApiExternalDocs(this Json.Schema.JsonSchema schema) { }
         public static string GetSummary(this Json.Schema.JsonSchema schema) { }
     }
     [Json.Schema.SchemaKeyword("nullable")]
@@ -299,7 +310,7 @@ namespace Microsoft.OpenApi.MicrosoftExtensions
     public class EnumDescription : Microsoft.OpenApi.Interfaces.IOpenApiElement
     {
         public EnumDescription() { }
-        public EnumDescription(Microsoft.OpenApi.Any.OpenApiObject source) { }
+        public EnumDescription(System.Text.Json.Nodes.JsonObject source) { }
         public string Description { get; set; }
         public string Name { get; set; }
         public string Value { get; set; }
@@ -313,15 +324,15 @@ namespace Microsoft.OpenApi.MicrosoftExtensions
         public string Version { get; set; }
         public static string Name { get; }
         public void Write(Microsoft.OpenApi.Writers.IOpenApiWriter writer, Microsoft.OpenApi.OpenApiSpecVersion specVersion) { }
-        public static Microsoft.OpenApi.MicrosoftExtensions.OpenApiDeprecationExtension Parse(Microsoft.OpenApi.Any.IOpenApiAny source) { }
+        public static Microsoft.OpenApi.MicrosoftExtensions.OpenApiDeprecationExtension Parse(Microsoft.OpenApi.Any.OpenApiAny source) { }
     }
     public class OpenApiEnumFlagsExtension : Microsoft.OpenApi.Interfaces.IOpenApiExtension
     {
         public OpenApiEnumFlagsExtension() { }
         public bool IsFlags { get; set; }
         public static string Name { get; }
         public void Write(Microsoft.OpenApi.Writers.IOpenApiWriter writer, Microsoft.OpenApi.OpenApiSpecVersion specVersion) { }
-        public static Microsoft.OpenApi.MicrosoftExtensions.OpenApiEnumFlagsExtension Parse(Microsoft.OpenApi.Any.IOpenApiAny source) { }
+        public static Microsoft.OpenApi.MicrosoftExtensions.OpenApiEnumFlagsExtension Parse(Microsoft.OpenApi.Any.OpenApiAny source) { }
     }
     public class OpenApiEnumValuesDescriptionExtension : Microsoft.OpenApi.Interfaces.IOpenApiExtension
     {
@@ -330,7 +341,7 @@ namespace Microsoft.OpenApi.MicrosoftExtensions
         public System.Collections.Generic.List<Microsoft.OpenApi.MicrosoftExtensions.EnumDescription> ValuesDescriptions { get; set; }
         public static string Name { get; }
         public void Write(Microsoft.OpenApi.Writers.IOpenApiWriter writer, Microsoft.OpenApi.OpenApiSpecVersion specVersion) { }
-        public static Microsoft.OpenApi.MicrosoftExtensions.OpenApiEnumValuesDescriptionExtension Parse(Microsoft.OpenApi.Any.IOpenApiAny source) { }
+        public static Microsoft.OpenApi.MicrosoftExtensions.OpenApiEnumValuesDescriptionExtension Parse(Microsoft.OpenApi.Any.OpenApiAny source) { }
     }
     public class OpenApiPagingExtension : Microsoft.OpenApi.Interfaces.IOpenApiExtension
     {
@@ -340,23 +351,23 @@ namespace Microsoft.OpenApi.MicrosoftExtensions
         public string OperationName { get; set; }
         public static string Name { get; }
         public void Write(Microsoft.OpenApi.Writers.IOpenApiWriter writer, Microsoft.OpenApi.OpenApiSpecVersion specVersion) { }
-        public static Microsoft.OpenApi.MicrosoftExtensions.OpenApiPagingExtension Parse(Microsoft.OpenApi.Any.IOpenApiAny source) { }
+        public static Microsoft.OpenApi.MicrosoftExtensions.OpenApiPagingExtension Parse(Microsoft.OpenApi.Any.OpenApiAny source) { }
     }
     public class OpenApiPrimaryErrorMessageExtension : Microsoft.OpenApi.Interfaces.IOpenApiExtension
     {
         public OpenApiPrimaryErrorMessageExtension() { }
         public bool IsPrimaryErrorMessage { get; set; }
         public static string Name { get; }
         public void Write(Microsoft.OpenApi.Writers.IOpenApiWriter writer, Microsoft.OpenApi.OpenApiSpecVersion specVersion) { }
-        public static Microsoft.OpenApi.MicrosoftExtensions.OpenApiPrimaryErrorMessageExtension Parse(Microsoft.OpenApi.Any.IOpenApiAny source) { }
+        public static Microsoft.OpenApi.MicrosoftExtensions.OpenApiPrimaryErrorMessageExtension Parse(Microsoft.OpenApi.Any.OpenApiAny source) { }
     }
     public class OpenApiReservedParameterExtension : Microsoft.OpenApi.Interfaces.IOpenApiExtension
     {
         public OpenApiReservedParameterExtension() { }
         public bool? IsReserved { get; set; }
         public static string Name { get; }
         public void Write(Microsoft.OpenApi.Writers.IOpenApiWriter writer, Microsoft.OpenApi.OpenApiSpecVersion specVersion) { }
-        public static Microsoft.OpenApi.MicrosoftExtensions.OpenApiReservedParameterExtension Parse(Microsoft.OpenApi.Any.IOpenApiAny source) { }
+        public static Microsoft.OpenApi.MicrosoftExtensions.OpenApiReservedParameterExtension Parse(Microsoft.OpenApi.Any.OpenApiAny source) { }
     }
 }
 namespace Microsoft.OpenApi.Models
@@ -1471,9 +1482,9 @@ namespace Microsoft.OpenApi.Writers
         void Flush();
         void WriteEndArray();
         void WriteEndObject();
-        void WriteJsonSchema(Json.Schema.JsonSchema schema);
-        void WriteJsonSchemaReference(Microsoft.OpenApi.Writers.IOpenApiWriter writer, System.Uri reference);
-        void WriteJsonSchemaWithoutReference(Microsoft.OpenApi.Writers.IOpenApiWriter writer, Json.Schema.JsonSchema schema);
+        void WriteJsonSchema(Json.Schema.JsonSchema schema, Microsoft.OpenApi.OpenApiSpecVersion version);
+        void WriteJsonSchemaReference(Microsoft.OpenApi.Writers.IOpenApiWriter writer, System.Uri reference, Microsoft.OpenApi.OpenApiSpecVersion version);
+        void WriteJsonSchemaWithoutReference(Microsoft.OpenApi.Writers.IOpenApiWriter writer, Json.Schema.JsonSchema schema, Microsoft.OpenApi.OpenApiSpecVersion version);
         void WriteNull();
         void WritePropertyName(string name);
         void WriteRaw(string value);
@@ -1534,9 +1545,9 @@ namespace Microsoft.OpenApi.Writers
         public abstract void WriteEndArray();
         public abstract void WriteEndObject();
         public virtual void WriteIndentation() { }
-        public void WriteJsonSchema(Json.Schema.JsonSchema schema) { }
-        public void WriteJsonSchemaReference(Microsoft.OpenApi.Writers.IOpenApiWriter writer, System.Uri reference) { }
-        public void WriteJsonSchemaWithoutReference(Microsoft.OpenApi.Writers.IOpenApiWriter writer, Json.Schema.JsonSchema schema) { }
+        public void WriteJsonSchema(Json.Schema.JsonSchema schema, Microsoft.OpenApi.OpenApiSpecVersion version) { }
+        public void WriteJsonSchemaReference(Microsoft.OpenApi.Writers.IOpenApiWriter writer, System.Uri referenceUri, Microsoft.OpenApi.OpenApiSpecVersion version) { }
+        public void WriteJsonSchemaWithoutReference(Microsoft.OpenApi.Writers.IOpenApiWriter writer, Json.Schema.JsonSchema schema, Microsoft.OpenApi.OpenApiSpecVersion version) { }
         public abstract void WriteNull();
         public abstract void WritePropertyName(string name);
         public abstract void WriteRaw(string value);
@@ -1572,6 +1583,8 @@ namespace Microsoft.OpenApi.Writers
             where T :  struct { }
         public static void WriteProperty<T>(this Microsoft.OpenApi.Writers.IOpenApiWriter writer, string name, T? value)
             where T :  struct { }
+        public static void WriteRequiredCollection<T>(this Microsoft.OpenApi.Writers.IOpenApiWriter writer, string name, System.Collections.Generic.IEnumerable<T> elements, System.Action<Microsoft.OpenApi.Writers.IOpenApiWriter, T> action)
+            where T : Microsoft.OpenApi.Interfaces.IOpenApiElement { }
         public static void WriteRequiredMap(this Microsoft.OpenApi.Writers.IOpenApiWriter writer, string name, System.Collections.Generic.IDictionary<string, string> elements, System.Action<Microsoft.OpenApi.Writers.IOpenApiWriter, string> action) { }
         public static void WriteRequiredMap<T>(this Microsoft.OpenApi.Writers.IOpenApiWriter writer, string name, System.Collections.Generic.IDictionary<string, T> elements, System.Action<Microsoft.OpenApi.Writers.IOpenApiWriter, T> action)
             where T : Microsoft.OpenApi.Interfaces.IOpenApiElement { }