feat: splits described and summarized interfaces

Signed-off-by: Vincent Biret <[email protected]>

Author: baywet

src/Microsoft.OpenApi/Models/Interfaces/IOpenApiDescribedElement.cs

@@ -3,15 +3,10 @@
 namespace Microsoft.OpenApi.Models.Interfaces;
 
 /// <summary>
-/// Describes an element that has a summary and description.
+/// Describes an element that has a description.
 /// </summary>
 public interface IOpenApiDescribedElement : IOpenApiElement
 {
-    /// <summary>
-    /// Short description for the example.
-    /// </summary>
-    public string Summary { get; set; }
-
     /// <summary>
     /// Long description for the example.
     /// CommonMark syntax MAY be used for rich text representation.

src/Microsoft.OpenApi/Models/Interfaces/IOpenApiExample.cs

@@ -7,7 +7,7 @@ namespace Microsoft.OpenApi.Models.Interfaces;
 /// Defines the base properties for the example object.
 /// This interface is provided for type assertions but should not be implemented by package consumers beyond automatic mocking.
 /// </summary>
-public interface IOpenApiExample : IOpenApiDescribedElement, IOpenApiSerializable, IOpenApiReadOnlyExtensible
+public interface IOpenApiExample : IOpenApiDescribedElement, IOpenApiSummarizedElement, IOpenApiSerializable, IOpenApiReadOnlyExtensible
 {
     /// <summary>
     /// Embedded literal example. The value field and externalValue field are mutually

src/Microsoft.OpenApi/Models/Interfaces/IOpenApiSummarizedElement.cs

@@ -0,0 +1,13 @@
+using Microsoft.OpenApi.Interfaces;
+
+namespace Microsoft.OpenApi.Models.Interfaces;
+/// <summary>
+/// Describes an element that has a summary.
+/// </summary>
+public interface IOpenApiSummarizedElement : IOpenApiElement
+{
+    /// <summary>
+    /// Short description for the example.
+    /// </summary>
+    public string Summary { get; set; }
+}