Enable SA1602 (#2055)

Author: akshay-zz

lib/PuppeteerSharp.ruleset

@@ -24,7 +24,7 @@
     <Rule Id="SA1124" Action="Error" /> <!-- Error SA1124: Don't use regions-->
     <Rule Id="SA1009" Action="Error" /> <!-- Error SA1009: Closing parenthesis should not be preceded by a space. (SA1009)-->
     <Rule Id="SA1413" Action="Error" /> <!-- Error SA1413: Use trailing comma in multi-line initializers (SA1413)-->
-    <Rule Id="SA1602" Action="None" /> <!-- Error SA1602: Enumeration items should be documented (SA1602)-->
+    <Rule Id="SA1602" Action="Error" /> <!-- Error SA1602: Enumeration items should be documented (SA1602)-->
     <Rule Id="SA1005" Action="Error" /> <!-- Error SA1005: Single line comment should begin with a space. (SA1005)-->
     <Rule Id="SA1203" Action="Error" /> <!-- Error SA1203: Constant fields should appear before non-constant fields (SA1203)-->
     <Rule Id="SA1720" Action="Error" /> <!-- Error SA1720: Name contains type-->

lib/PuppeteerSharp/DOMWorldType.cs

@@ -7,9 +7,20 @@ namespace PuppeteerSharp
     [JsonConverter(typeof(FlexibleStringEnumConverter), Other)]
     internal enum DOMWorldType
     {
+        /// <summary>
+        /// Other type
+        /// </summary>
         Other,
+
+        /// <summary>
+        /// Isolated type
+        /// </summary>
         [EnumMember(Value = "isolated")]
         Isolated,
+
+        /// <summary>
+        /// Default type
+        /// </summary>
         [EnumMember(Value = "default")]
         Default,
     }

lib/PuppeteerSharp/Helpers/Linux/FileAccessPermissions.cs

@@ -5,23 +5,74 @@ namespace PuppeteerSharp.Helpers.Linux
     [Flags]
     internal enum FileAccessPermissions : uint
     {
+        /// <summary>
+        /// Other execution permission
+        /// </summary>
         OtherExecute = 1,
+
+        /// <summary>
+        /// Other write permission
+        /// </summary>
         OtherWrite = 2,
+
+        /// <summary>
+        /// Other read permission
+        /// </summary>
         OtherRead = 4,
 
+        /// <summary>
+        /// Group execution permission
+        /// </summary>
         GroupExecute = 8,
+
+        /// <summary>
+        /// Group write permission
+        /// </summary>
         GroupWrite = 16,
+
+        /// <summary>
+        /// Group read permission
+        /// </summary>
         GroupRead = 32,
 
+        /// <summary>
+        /// User execution permission
+        /// </summary>
         UserExecute = 64,
+
+        /// <summary>
+        /// User writer permission
+        /// </summary>
         UserWrite = 128,
+
+        /// <summary>
+        /// User read permission
+        /// </summary>
         UserRead = 256,
 
+        /// <summary>
+        /// Other read, write and execution permissions
+        /// </summary>
         OtherReadWriteExecute = OtherRead | OtherWrite | OtherExecute,
+
+        /// <summary>
+        /// Group read, write and execution permissions
+        /// </summary>
         GroupReadWriteExecute = GroupRead | GroupWrite | GroupExecute,
+
+        /// <summary>
+        /// User read, write and execution permissions
+        /// </summary>
         UserReadWriteExecute = UserRead | UserWrite | UserExecute,
 
+        /// <summary>
+        /// Default permissions
+        /// </summary>
         DefaultPermissions = OtherWrite | OtherRead | GroupWrite | GroupRead | UserWrite | UserRead,
+
+        /// <summary>
+        /// All permissions
+        /// </summary>
         AllPermissions = DefaultPermissions | OtherExecute | GroupExecute | UserExecute,
     }
 }

lib/PuppeteerSharp/Input/PointerType.cs

@@ -1,4 +1,4 @@
-using System.Runtime.Serialization;
+using System.Runtime.Serialization;
 using Newtonsoft.Json;
 using Newtonsoft.Json.Converters;
 
@@ -7,8 +7,15 @@ namespace PuppeteerSharp.Input
     [JsonConverter(typeof(StringEnumConverter))]
     internal enum PointerType
     {
+        /// <summary>
+        /// Mouse
+        /// </summary>
         [EnumMember(Value = "mouse")]
         Mouse,
+
+        /// <summary>
+        /// Pen
+        /// </summary>
         [EnumMember(Value = "pen")]
         Pen,
     }

lib/PuppeteerSharp/Messaging/DispatchKeyEventType.cs

@@ -7,10 +7,21 @@ namespace PuppeteerSharp.Messaging
     [JsonConverter(typeof(StringEnumConverter))]
     internal enum DispatchKeyEventType
     {
+        /// <summary>
+        /// Key down
+        /// </summary>
         [EnumMember(Value = "keyDown")]
         KeyDown,
+
+        /// <summary>
+        /// Raw key down
+        /// </summary>
         [EnumMember(Value = "rawKeyDown")]
         RawKeyDown,
+
+        /// <summary>
+        /// Key up
+        /// </summary>
         [EnumMember(Value = "keyUp")]
         KeyUp,
     }

lib/PuppeteerSharp/Messaging/DragEventType.cs

@@ -1,4 +1,4 @@
-using System.Runtime.Serialization;
+using System.Runtime.Serialization;
 using Newtonsoft.Json;
 using Newtonsoft.Json.Converters;
 
@@ -7,10 +7,21 @@ namespace PuppeteerSharp.Messaging
     [JsonConverter(typeof(StringEnumConverter))]
     internal enum DragEventType
     {
+        /// <summary>
+        /// Drag event
+        /// </summary>
         [EnumMember(Value = "dragEnter")]
         DragEnter,
+
+        /// <summary>
+        /// Drag over
+        /// </summary>
         [EnumMember(Value = "dragOver")]
         DragOver,
+
+        /// <summary>
+        /// Drop
+        /// </summary>
         [EnumMember(Value = "drop")]
         Drop,
     }

lib/PuppeteerSharp/Messaging/FileChooserAction.cs

@@ -7,10 +7,21 @@ namespace PuppeteerSharp.Messaging
     [JsonConverter(typeof(StringEnumConverter))]
     internal enum FileChooserAction
     {
+        /// <summary>
+        /// Accept
+        /// </summary>
         [EnumMember(Value = "accept")]
         Accept,
+
+        /// <summary>
+        /// Fallback
+        /// </summary>
         [EnumMember(Value = "fallback")]
         Fallback,
+
+        /// <summary>
+        /// Cancel
+        /// </summary>
         [EnumMember(Value = "cancel")]
         Cancel,
     }

lib/PuppeteerSharp/Messaging/MouseEventType.cs

@@ -7,12 +7,27 @@ namespace PuppeteerSharp.Messaging
     [JsonConverter(typeof(StringEnumConverter))]
     internal enum MouseEventType
     {
+        /// <summary>
+        /// Mouse moved
+        /// </summary>
         [EnumMember(Value = "mouseMoved")]
         MouseMoved,
+
+        /// <summary>
+        /// Mouse clicked
+        /// </summary>
         [EnumMember(Value = "mousePressed")]
         MousePressed,
+
+        /// <summary>
+        /// Mouse click released
+        /// </summary>
         [EnumMember(Value = "mouseReleased")]
         MouseReleased,
+
+        /// <summary>
+        /// Mouse wheel
+        /// </summary>
         [EnumMember(Value = "mouseWheel")]
         MouseWheel,
     }

lib/PuppeteerSharp/Messaging/PageFrameDetachedResponse.cs

@@ -6,8 +6,19 @@ namespace PuppeteerSharp.Messaging
     [JsonConverter(typeof(FlexibleStringEnumConverter), Unknown)]
     internal enum FrameDetachedReason
     {
+        /// <summary>
+        /// Unknown
+        /// </summary>
         Unknown = -1,
+
+        /// <summary>
+        /// Remove
+        /// </summary>
         Remove,
+
+        /// <summary>
+        /// Swap
+        /// </summary>
         Swap,
     }