Improve documentation comment styles

Author: sharwell

StyleCop.Analyzers/StyleCop.Analyzers.Test/MaintainabilityRules/SA1402SettingsConfiguration.cs

@@ -11,12 +11,12 @@ public enum SA1402SettingsConfiguration
         KeepDefaultConfiguration,
 
         /// <summary>
-        /// Provide custom settings that configure the tested type as being a top level type.
+        /// Provide custom settings that configure the tested type as being a top-level type.
         /// </summary>
         ConfigureAsTopLevelType,
 
         /// <summary>
-        /// Provide custom settings that configure the tested type as not being a top level type.
+        /// Provide custom settings that configure the tested type as not being a top-level type.
         /// </summary>
         ConfigureAsNonTopLevelType,
     }

StyleCop.Analyzers/StyleCop.Analyzers/Helpers/MemberOrderHelper.cs

@@ -103,17 +103,17 @@ private enum ModifierFlags
             None = 0,
 
             /// <summary>
-            /// Readonly modifier.
+            /// <see langword="readonly"/> modifier.
             /// </summary>
             Readonly = 1,
 
             /// <summary>
-            /// Static modifier.
+            /// <see langword="static"/> modifier.
             /// </summary>
             Static = 1 << 2,
 
             /// <summary>
-            /// Const modifier.
+            /// <see langword="const"/> modifier.
             /// </summary>
             Const = 1 << 3,
         }

StyleCop.Analyzers/StyleCop.Analyzers/Helpers/ModifierOrderHelper.cs

@@ -19,17 +19,17 @@ internal enum ModifierType
             None,
 
             /// <summary>
-            /// Represents any of access modifiers i.e public, protected, internal, private.
+            /// Represents any of access modifiers, i.e <see langword="public"/>, <see langword="protected"/>, <see langword="internal"/>, <see langword="private"/>.
             /// </summary>
             Access,
 
             /// <summary>
-            /// Represents static modifier.
+            /// Represents <see langword="static"/> modifier.
             /// </summary>
             Static,
 
             /// <summary>
-            /// Represents other modifiers i.e partial, virtual, abstract, override, extern, unsafe, new, async, const, sealed, readonly, volatile, fixed, ref.
+            /// Represents other modifiers, i.e <see langword="partial"/>, <see langword="virtual"/>, <see langword="abstract"/>, <see langword="override"/>, <see langword="extern"/>, <see langword="unsafe"/>, <see langword="new"/>, <see langword="async"/>, <see langword="const"/>, <see langword="sealed"/>, <see langword="readonly"/>, <see langword="volatile"/>, <see langword="fixed"/>, <see langword="ref"/>.
             /// </summary>
             Other,
         }

StyleCop.Analyzers/StyleCop.Analyzers/Settings/ObjectModel/FileNamingConvention.cs

@@ -6,12 +6,12 @@ namespace StyleCop.Analyzers.Settings.ObjectModel
     internal enum FileNamingConvention
     {
         /// <summary>
-        /// Files are named using the StyleCop convention (e.g. TypeName{T1,T2}).
+        /// Files are named using the StyleCop convention (e.g. <c>TypeName{T1,T2}</c>).
         /// </summary>
         StyleCop,
 
         /// <summary>
-        /// Files are named using the metadata convention (e.g. TypeName`2).
+        /// Files are named using the metadata convention (e.g. <c>TypeName`2</c>).
         /// </summary>
         Metadata,
     }