fix: enhance XML documentation for enums in Enums.cs for clarity and completeness

Author: jbrinkman

src/DotNetApiDiff/Models/Enums.cs

@@ -6,10 +6,29 @@ namespace DotNetApiDiff.Models;
 /// </summary>
 public enum ChangeType
 {
+    /// <summary>
+    /// Indicates a new API element was added
+    /// </summary>
     Added,
+
+    /// <summary>
+    /// Indicates an API element was removed
+    /// </summary>
     Removed,
+
+    /// <summary>
+    /// Indicates an API element was modified
+    /// </summary>
     Modified,
+
+    /// <summary>
+    /// Indicates an API element was moved to a different location
+    /// </summary>
     Moved,
+
+    /// <summary>
+    /// Indicates an API element was excluded from the comparison
+    /// </summary>
     Excluded,
 }
 
@@ -18,13 +37,44 @@ public enum ChangeType
 /// </summary>
 public enum ApiElementType
 {
+    /// <summary>
+    /// Represents an assembly element
+    /// </summary>
     Assembly,
+
+    /// <summary>
+    /// Represents a namespace element
+    /// </summary>
     Namespace,
+
+    /// <summary>
+    /// Represents a type element (class, interface, struct, etc.)
+    /// </summary>
     Type,
+
+    /// <summary>
+    /// Represents a method element
+    /// </summary>
     Method,
+
+    /// <summary>
+    /// Represents a property element
+    /// </summary>
     Property,
+
+    /// <summary>
+    /// Represents a field element
+    /// </summary>
     Field,
+
+    /// <summary>
+    /// Represents an event element
+    /// </summary>
     Event,
+
+    /// <summary>
+    /// Represents a constructor element
+    /// </summary>
     Constructor,
 }
 
@@ -33,15 +83,54 @@ public enum ApiElementType
 /// </summary>
 public enum MemberType
 {
+    /// <summary>
+    /// Represents a class type
+    /// </summary>
     Class,
+
+    /// <summary>
+    /// Represents an interface type
+    /// </summary>
     Interface,
+
+    /// <summary>
+    /// Represents a structure type
+    /// </summary>
     Struct,
+
+    /// <summary>
+    /// Represents an enumeration type
+    /// </summary>
     Enum,
+
+    /// <summary>
+    /// Represents a delegate type
+    /// </summary>
     Delegate,
+
+    /// <summary>
+    /// Represents a method member
+    /// </summary>
     Method,
+
+    /// <summary>
+    /// Represents a property member
+    /// </summary>
     Property,
+
+    /// <summary>
+    /// Represents a field member
+    /// </summary>
     Field,
+
+    /// <summary>
+    /// Represents an event member
+    /// </summary>
     Event,
+
+    /// <summary>
+    /// Represents a constructor member
+    /// </summary>
     Constructor,
 }
 
@@ -50,11 +139,34 @@ public enum MemberType
 /// </summary>
 public enum AccessibilityLevel
 {
+    /// <summary>
+    /// Accessible only within the containing type
+    /// </summary>
     Private,
+
+    /// <summary>
+    /// Accessible within the containing type and derived types
+    /// </summary>
     Protected,
+
+    /// <summary>
+    /// Accessible within the containing assembly
+    /// </summary>
     Internal,
+
+    /// <summary>
+    /// Accessible within the containing assembly and derived types in any assembly
+    /// </summary>
     ProtectedInternal,
+
+    /// <summary>
+    /// Accessible within the containing type and derived types within the same assembly
+    /// </summary>
     ProtectedPrivate,
+
+    /// <summary>
+    /// Accessible without restrictions
+    /// </summary>
     Public,
 }
 
@@ -63,9 +175,24 @@ public enum AccessibilityLevel
 /// </summary>
 public enum SeverityLevel
 {
+    /// <summary>
+    /// Informational change with no impact on compatibility
+    /// </summary>
     Info,
+
+    /// <summary>
+    /// Change that may impact compatibility in some scenarios
+    /// </summary>
     Warning,
+
+    /// <summary>
+    /// Change that will likely break compatibility
+    /// </summary>
     Error,
+
+    /// <summary>
+    /// Change that will definitely break compatibility in a significant way
+    /// </summary>
     Critical,
 }
 
@@ -74,9 +201,28 @@ public enum SeverityLevel
 /// </summary>
 public enum ReportFormat
 {
+    /// <summary>
+    /// Output report to console in a readable text format
+    /// </summary>
     Console,
+
+    /// <summary>
+    /// Output report in JSON format
+    /// </summary>
     Json,
+
+    /// <summary>
+    /// Output report in XML format
+    /// </summary>
     Xml,
+
+    /// <summary>
+    /// Output report in HTML format
+    /// </summary>
     Html,
+
+    /// <summary>
+    /// Output report in Markdown format
+    /// </summary>
     Markdown,
 }