minor edits of doc comments

Author: WalkerCodeRanger

Semver/IntExtensions.cs

@@ -20,13 +20,13 @@ public static int Digits(this int n)
         {
             if (n < 10) return 1;
             if (n < 100) return 2;
-            if (n < 1000) return 3;
-            if (n < 10000) return 4;
-            if (n < 100000) return 5;
-            if (n < 1000000) return 6;
-            if (n < 10000000) return 7;
-            if (n < 100000000) return 8;
-            if (n < 1000000000) return 9;
+            if (n < 1_000) return 3;
+            if (n < 10_000) return 4;
+            if (n < 100_000) return 5;
+            if (n < 1_000_000) return 6;
+            if (n < 10_000_000) return 7;
+            if (n < 100_000_000) return 8;
+            if (n < 1_000_000_000) return 9;
             return 10;
         }
     }

Semver/SemVersion.cs

@@ -99,12 +99,12 @@ public SemVersion(Version version)
         /// Converts the string representation of a semantic version to its <see cref="SemVersion"/> equivalent.
         /// </summary>
         /// <param name="version">The version string.</param>
-        /// <param name="strict">If set to <see langword="true"/> minor and patch version are required.
+        /// <param name="strict">If set to <see langword="true"/> minor and patch version are required,
         /// otherwise they are optional.</param>
         /// <returns>The <see cref="SemVersion"/> object.</returns>
         /// <exception cref="ArgumentNullException">The <paramref name="version"/> is <see langword="null"/>.</exception>
-        /// <exception cref="ArgumentException">The version number has an invalid format.</exception>
-        /// <exception cref="InvalidOperationException">The version number is missing Minor or Patch versions when they are required.</exception>
+        /// <exception cref="ArgumentException">The <paramref name="version"/> has an invalid format.</exception>
+        /// <exception cref="InvalidOperationException">The <paramref name="version"/> is missing Minor or Patch versions and <paramref name="strict"/> is <see langword="true"/>.</exception>
         /// <exception cref="OverflowException">The Major, Minor, or Patch versions are larger than <code>int.MaxValue</code>.</exception>
         public static SemVersion Parse(string version, bool strict = false)
         {
@@ -142,7 +142,7 @@ public static SemVersion Parse(string version, bool strict = false)
         /// <param name="semver">When the method returns, contains a <see cref="SemVersion"/> instance equivalent
         /// to the version string passed in, if the version string was valid, or <see langword="null"/> if the
         /// version string was not valid.</param>
-        /// <param name="strict">If set to <see langword="true"/> minor and patch version are required.
+        /// <param name="strict">If set to <see langword="true"/> minor and patch version are required,
         /// otherwise they are optional.</param>
         /// <returns><see langword="false"/> when a invalid version string is passed, otherwise <see langword="true"/>.</returns>
         public static bool TryParse(string version, out SemVersion semver, bool strict = false)
@@ -186,7 +186,7 @@ public static bool TryParse(string version, out SemVersion semver, bool strict =
         /// </summary>
         /// <param name="versionA">The first version to compare.</param>
         /// <param name="versionB">The second version to compare.</param>
-        /// <returns><see langword="true"/> if the two values are equal; otherwise, <see langword="false"/>.</returns>
+        /// <returns><see langword="true"/> if the two values are equal, otherwise <see langword="false"/>.</returns>
         public static bool Equals(SemVersion versionA, SemVersion versionB)
         {
             if (ReferenceEquals(versionA, versionB)) return true;
@@ -199,7 +199,7 @@ public static bool Equals(SemVersion versionA, SemVersion versionB)
         /// </summary>
         /// <param name="versionA">The first version to compare.</param>
         /// <param name="versionB">The second version to compare.</param>
-        /// <returns>A signed number indicating the relative values of <code>versionA</code> and <code>versionB</code>.</returns>
+        /// <returns>A signed number indicating the relative values of <paramref name="versionA"/> and <paramref name="versionB"/>.</returns>
         public static int Compare(SemVersion versionA, SemVersion versionB)
         {
             if (ReferenceEquals(versionA, versionB)) return 0;
@@ -218,9 +218,13 @@ public static int Compare(SemVersion versionA, SemVersion versionB)
         /// <param name="build">The value to replace the build metadata or <see langword="null"/> to leave it unchanged.</param>
         /// <returns>The new version object.</returns>
         /// <remarks>
-        /// The change method is intended to be called using named argument syntax.
-        /// For example, to change the patch version, use <code>version.Change(patch: 4)</code>.
+        /// The change method is intended to be called using named argument syntax, passing only
+        /// those fields to be changed.
         /// </remarks>
+        /// <example>
+        /// To change only the patch version:
+        /// <code>version.Change(patch: 4)</code>
+        /// </example>
         public SemVersion Change(int? major = null, int? minor = null, int? patch = null,
             string prerelease = null, string build = null)
         {
@@ -433,7 +437,7 @@ private static int CompareComponent(string a, string b, bool nonemptyIsLower = f
         /// </summary>
         /// <param name="obj">The <see cref="object" /> to compare with this instance.</param>
         /// <returns>
-        ///   <see langword="true"/> if the specified <see cref="object" /> is equal to this instance; otherwise, <see langword="false"/>.
+        ///   <see langword="true"/> if the specified <see cref="object" /> is equal to this instance, otherwise <see langword="false"/>.
         /// </returns>
         /// <exception cref="InvalidCastException">The <paramref name="obj"/> is not a <see cref="SemVersion"/>.</exception>
         public override bool Equals(object obj)