Update the XML doc comments

Author: TolikPylypchuk

Matchmaker/AsyncMatch.cs

@@ -66,9 +66,8 @@ public static AsyncMatch<TInput> Create<TInput>(bool fallthroughByDefault) =>
     /// <returns>The globally cached match expression.</returns>
     /// <remarks>
     /// <para>
-    /// The key of the cache is the location of this method's call in the source code.
-    /// This way, a new match expression object will not be allocated every time pattern matching occurs
-    /// in the same place more than once.
+    /// The key of the cache is the location of this method's call in the source code. This way, a new match expression
+    /// object will not be allocated every time pattern matching occurs in the same place more than once.
     /// </para>
     /// <para>
     /// The pattern caching process is thread-safe.
@@ -112,9 +111,8 @@ public static AsyncMatch<TInput, TOutput> CreateStatic<TInput, TOutput>(
     /// <returns>The globally cached match expression.</returns>
     /// <remarks>
     /// <para>
-    /// The key of the cache is the location of this method's call in the source code.
-    /// This way, a new match statement object will not be allocated every time pattern matching occurs
-    /// in the same place more than once.
+    /// The key of the cache is the location of this method's call in the source code. This way, a new match expression
+    /// object will not be allocated every time pattern matching occurs in the same place more than once.
     /// </para>
     /// <para>
     /// The pattern caching process is thread-safe.
@@ -155,7 +153,7 @@ public static AsyncMatch<TInput> CreateStatic<TInput>(
     /// <typeparam name="TOutput">The type of the result.</typeparam>
     /// <remarks>
     /// <para>
-    /// After calling this method all
+    /// After calling this method, all
     /// <see cref="CreateStatic{TInput, TOutput}(Action{AsyncMatchBuilder{TInput, TOutput}}, string, int)" />
     /// calls will recalculate match expressions for types <typeparamref name="TInput" /> and
     /// <typeparamref name="TOutput" />.
@@ -173,7 +171,7 @@ public static void ClearCache<TInput, TOutput>() =>
     /// <typeparam name="TInput">The type of the input value.</typeparam>
     /// <remarks>
     /// <para>
-    /// After calling this method all
+    /// After calling this method, all
     /// <see cref="CreateStatic{TInput}(Action{AsyncMatchBuilder{TInput}}, string, int)" />
     /// calls will recalculate match statements for type <typeparamref name="TInput" />.
     /// </para>

Matchmaker/AsyncMatch_1.cs

@@ -58,15 +58,15 @@ private AsyncMatch(IReadOnlyCollection<CaseData> cases, bool fallthroughByDefaul
     internal static ConcurrentDictionary<string, AsyncMatch<TInput>> Cache { get; } = new();
 
     /// <summary>
-    /// Returns a new match statement which includes the specified pattern and action to execute if this
-    /// pattern is matched successfully.
+    /// Returns a new match statement which includes the specified pattern and action to execute if this pattern is
+    /// matched successfully.
     /// </summary>
     /// <typeparam name="TMatchResult">The type of the result of the pattern's match.</typeparam>
     /// <param name="pattern">The pattern to match with.</param>
     /// <param name="action">The action to execute if the match is successful.</param>
     /// <returns>
-    /// A new match statement which includes the specified pattern and action to execute if this
-    /// pattern is matched successfully.
+    /// A new match statement which includes the specified pattern and action to execute if this pattern is matched
+    /// successfully.
     /// </returns>
     /// <exception cref="ArgumentNullException">
     /// <paramref name="pattern" /> or <paramref name="action" /> is <see langword="null" />.
@@ -77,15 +77,15 @@ public AsyncMatch<TInput> Case<TMatchResult>(
         this.Case(pattern, this.fallthroughByDefault, action);
 
     /// <summary>
-    /// Returns a new match statement which includes the specified pattern and action to execute if this
-    /// pattern is matched successfully.
+    /// Returns a new match statement which includes the specified pattern and action to execute if this pattern is
+    /// matched successfully.
     /// </summary>
     /// <typeparam name="TMatchResult">The type of the result of the pattern's match.</typeparam>
     /// <param name="pattern">The pattern to match with.</param>
     /// <param name="action">The action to execute if the match is successful.</param>
     /// <returns>
-    /// A new match statement which includes the specified pattern and action to execute if this
-    /// pattern is matched successfully.
+    /// A new match statement which includes the specified pattern and action to execute if this pattern is matched
+    /// successfully.
     /// </returns>
     /// <exception cref="ArgumentNullException">
     /// <paramref name="pattern" /> or <paramref name="action" /> is <see langword="null" />.
@@ -96,15 +96,15 @@ public AsyncMatch<TInput> Case<TMatchResult>(
         this.Case(pattern, this.fallthroughByDefault, action.AsAsync());
 
     /// <summary>
-    /// Returns a new match statement which includes the specified pattern and action to execute if this
-    /// pattern is matched successfully.
+    /// Returns a new match statement which includes the specified pattern and action to execute if this pattern is
+    /// matched successfully.
     /// </summary>
     /// <typeparam name="TMatchResult">The type of the result of the pattern's match.</typeparam>
     /// <param name="pattern">The pattern to match with.</param>
     /// <param name="action">The action to execute if the match is successful.</param>
     /// <returns>
-    /// A new match statement which includes the specified pattern and action to execute if this
-    /// pattern is matched successfully.
+    /// A new match statement which includes the specified pattern and action to execute if this pattern is matched
+    /// successfully.
     /// </returns>
     /// <exception cref="ArgumentNullException">
     /// <paramref name="pattern" /> or <paramref name="action" /> is <see langword="null" />.
@@ -115,15 +115,15 @@ public AsyncMatch<TInput> Case<TMatchResult>(
         this.Case(pattern.AsAsync(), this.fallthroughByDefault, action);
 
     /// <summary>
-    /// Returns a new match statement which includes the specified pattern and action to execute if this
-    /// pattern is matched successfully.
+    /// Returns a new match statement which includes the specified pattern and action to execute if this pattern is
+    /// matched successfully.
     /// </summary>
     /// <typeparam name="TMatchResult">The type of the result of the pattern's match.</typeparam>
     /// <param name="pattern">The pattern to match with.</param>
     /// <param name="action">The action to execute if the match is successful.</param>
     /// <returns>
-    /// A new match statement which includes the specified pattern and action to execute if this
-    /// pattern is matched successfully.
+    /// A new match statement which includes the specified pattern and action to execute if this pattern is matched
+    /// successfully.
     /// </returns>
     /// <exception cref="ArgumentNullException">
     /// <paramref name="pattern" /> or <paramref name="action" /> is <see langword="null" />.
@@ -134,16 +134,16 @@ public AsyncMatch<TInput> Case<TMatchResult>(
         this.Case(pattern.AsAsync(), this.fallthroughByDefault, action.AsAsync());
 
     /// <summary>
-    /// Returns a new match statement which includes the specified pattern and action to execute if this
-    /// pattern is matched successfully.
+    /// Returns a new match statement which includes the specified pattern and action to execute if this pattern is
+    /// matched successfully.
     /// </summary>
     /// <typeparam name="TMatchResult">The type of the result of the pattern's match.</typeparam>
     /// <param name="pattern">The pattern to match with.</param>
     /// <param name="fallthrough">The fallthrough behaviour.</param>
     /// <param name="action">The action to execute if the match is successful.</param>
     /// <returns>
-    /// A new match statement which includes the specified pattern and action to execute if this
-    /// pattern is matched successfully.
+    /// A new match statement which includes the specified pattern and action to execute if this pattern is matched
+    /// successfully.
     /// </returns>
     /// <exception cref="ArgumentNullException">
     /// <paramref name="pattern" /> or <paramref name="action" /> is <see langword="null" />.
@@ -167,16 +167,16 @@ public AsyncMatch<TInput> Case<TMatchResult>(
             : throw new ArgumentNullException(nameof(pattern));
 
     /// <summary>
-    /// Returns a new match statement which includes the specified pattern and action to execute if this
-    /// pattern is matched successfully.
+    /// Returns a new match statement which includes the specified pattern and action to execute if this pattern is
+    /// matched successfully.
     /// </summary>
     /// <typeparam name="TMatchResult">The type of the result of the pattern's match.</typeparam>
     /// <param name="pattern">The pattern to match with.</param>
     /// <param name="fallthrough">The fallthrough behaviour.</param>
     /// <param name="action">The action to execute if the match is successful.</param>
     /// <returns>
-    /// A new match statement which includes the specified pattern and action to execute if this
-    /// pattern is matched successfully.
+    /// A new match statement which includes the specified pattern and action to execute if this pattern is matched
+    /// successfully.
     /// </returns>
     /// <exception cref="ArgumentNullException">
     /// <paramref name="pattern" /> or <paramref name="action" /> is <see langword="null" />.
@@ -188,16 +188,16 @@ public AsyncMatch<TInput> Case<TMatchResult>(
         this.Case(pattern, fallthrough, action.AsAsync());
 
     /// <summary>
-    /// Returns a new match statement which includes the specified pattern and action to execute if this
-    /// pattern is matched successfully.
+    /// Returns a new match statement which includes the specified pattern and action to execute if this pattern is
+    /// matched successfully.
     /// </summary>
     /// <typeparam name="TMatchResult">The type of the result of the pattern's match.</typeparam>
     /// <param name="pattern">The pattern to match with.</param>
     /// <param name="fallthrough">The fallthrough behaviour.</param>
     /// <param name="action">The action to execute if the match is successful.</param>
     /// <returns>
-    /// A new match statement which includes the specified pattern and action to execute if this
-    /// pattern is matched successfully.
+    /// A new match statement which includes the specified pattern and action to execute if this pattern is matched
+    /// successfully.
     /// </returns>
     /// <exception cref="ArgumentNullException">
     /// <paramref name="pattern" /> or <paramref name="action" /> is <see langword="null" />.
@@ -209,16 +209,16 @@ public AsyncMatch<TInput> Case<TMatchResult>(
         this.Case(pattern.AsAsync(), fallthrough, action);
 
     /// <summary>
-    /// Returns a new match statement which includes the specified pattern and action to execute if this
-    /// pattern is matched successfully.
+    /// Returns a new match statement which includes the specified pattern and action to execute if this pattern is
+    /// matched successfully.
     /// </summary>
     /// <typeparam name="TMatchResult">The type of the result of the pattern's match.</typeparam>
     /// <param name="pattern">The pattern to match with.</param>
     /// <param name="fallthrough">The fallthrough behaviour.</param>
     /// <param name="action">The action to execute if the match is successful.</param>
     /// <returns>
-    /// A new match statement which includes the specified pattern and action to execute if this
-    /// pattern is matched successfully.
+    /// A new match statement which includes the specified pattern and action to execute if this pattern is matched
+    /// successfully.
     /// </returns>
     /// <exception cref="ArgumentNullException">
     /// <paramref name="pattern" /> or <paramref name="action" /> is <see langword="null" />.
@@ -230,14 +230,14 @@ public AsyncMatch<TInput> Case<TMatchResult>(
         this.Case(pattern.AsAsync(), fallthrough, action.AsAsync());
 
     /// <summary>
-    /// Returns a new match statement which includes the pattern for the specified type
-    /// and action to execute if this pattern is matched successfully.
+    /// Returns a new match statement which includes the pattern for the specified type and action to execute if this
+    /// pattern is matched successfully.
     /// </summary>
     /// <typeparam name="TType">The type of the result of the pattern's match.</typeparam>
     /// <param name="action">The action to execute if the match is successful.</param>
     /// <returns>
-    /// A new match statement which includes the type pattern and action to execute if this
-    /// pattern is matched successfully.
+    /// A new match statement which includes the type pattern and action to execute if this pattern is matched
+    /// successfully.
     /// </returns>
     /// <remarks>
     /// This method is functionally equivalent to the following:
@@ -253,14 +253,14 @@ public AsyncMatch<TInput> Case<TType>(Func<TType, Task> action)
         this.Case(this.fallthroughByDefault, action);
 
     /// <summary>
-    /// Returns a new match statement which includes the pattern for the specified type
-    /// and action to execute if this pattern is matched successfully.
+    /// Returns a new match statement which includes the pattern for the specified type and action to execute if this
+    /// pattern is matched successfully.
     /// </summary>
     /// <typeparam name="TType">The type of the result of the pattern's match.</typeparam>
     /// <param name="action">The action to execute if the match is successful.</param>
     /// <returns>
-    /// A new match statement which includes the type pattern and action to execute if this
-    /// pattern is matched successfully.
+    /// A new match statement which includes the type pattern and action to execute if this pattern is matched
+    /// successfully.
     /// </returns>
     /// <remarks>
     /// This method is functionally equivalent to the following:
@@ -276,15 +276,15 @@ public AsyncMatch<TInput> Case<TType>(Action<TType> action)
         this.Case(action.AsAsync());
 
     /// <summary>
-    /// Returns a new match statement which includes the pattern for the specified type
-    /// and action to execute if this pattern is matched successfully.
+    /// Returns a new match statement which includes the pattern for the specified type and action to execute if this
+    /// pattern is matched successfully.
     /// </summary>
     /// <typeparam name="TType">The type of the result of the pattern's match.</typeparam>
     /// <param name="fallthrough">The fallthrough behaviour.</param>
     /// <param name="action">The action to execute if the match is successful.</param>
     /// <returns>
-    /// A new match statement which includes the type pattern and action to execute if this
-    /// pattern is matched successfully.
+    /// A new match statement which includes the type pattern and action to execute if this pattern is matched
+    /// successfully.
     /// </returns>
     /// <remarks>
     /// This method is functionally equivalent to the following:
@@ -300,15 +300,15 @@ public AsyncMatch<TInput> Case<TType>(bool fallthrough, Func<TType, Task> action
         this.Case(AsyncPattern.Type<TInput, TType>(), fallthrough, action);
 
     /// <summary>
-    /// Returns a new match statement which includes the pattern for the specified type
-    /// and action to execute if this pattern is matched successfully.
+    /// Returns a new match statement which includes the pattern for the specified type and action to execute if this
+    /// pattern is matched successfully.
     /// </summary>
     /// <typeparam name="TType">The type of the result of the pattern's match.</typeparam>
     /// <param name="fallthrough">The fallthrough behaviour.</param>
     /// <param name="action">The action to execute if the match is successful.</param>
     /// <returns>
-    /// A new match statement which includes the type pattern and action to execute if this
-    /// pattern is matched successfully.
+    /// A new match statement which includes the type pattern and action to execute if this pattern is matched
+    /// successfully.
     /// </returns>
     /// <remarks>
     /// This method is functionally equivalent to the following:
@@ -345,8 +345,7 @@ public async Task ExecuteAsync(TInput input)
     /// </summary>
     /// <param name="input">The input value of the statement.</param>
     /// <returns>
-    /// <see langword="true" />, if the match was successful.
-    /// Otherwise, <see langword="false" />.
+    /// <see langword="true" />, if the match was successful. Otherwise, <see langword="false" />.
     /// </returns>
     public async Task<bool> ExecuteNonStrictAsync(TInput input)
     {
@@ -368,8 +367,8 @@ public async Task<bool> ExecuteNonStrictAsync(TInput input)
     /// </summary>
     /// <param name="input">The input value of the statement.</param>
     /// <returns>
-    /// An enumerable of <see langword="null" /> objects which enables the execution to be lazy.
-    /// The number of items in this enumerable equals the number of successful cases.
+    /// An enumerable of <see langword="null" /> objects which enables the execution to be lazy. The number of items in
+    /// this enumerable equals the number of successful cases.
     /// </returns>
     public async IAsyncEnumerable<object?> ExecuteWithFallthroughAsync(TInput input)
     {