More doc comment additions

\n\nCommit migrated from 551e7c269a

src/ObjectPool/src/ObjectPool.cs

@@ -10,9 +10,9 @@ namespace Microsoft.Extensions.ObjectPool
     public abstract class ObjectPool<T> where T : class
     {
         /// <summary>
-        /// Returns an object from the pool.
+        /// Gets an object from the pool is one is available, otherwise creates one.
         /// </summary>
-        /// <returns>An object from the pool.</returns>
+        /// <returns>A <typeparamref name="T"/>.</returns>
         public abstract T Get();
 
         /// <summary>

src/Shared/CommandLineUtils/Utilities/ArgumentEscaper.cs

@@ -19,8 +19,8 @@ namespace Microsoft.Extensions.CommandLineUtils
         /// <remarks>
         /// See https://blogs.msdn.microsoft.com/twistylittlepassagesallalike/2011/04/23/everyone-quotes-command-line-arguments-the-wrong-way/
         /// </remarks>
-        /// <param name="args"></param>
-        /// <returns></returns>
+        /// <param name="args">The arguments to concatenate.</param>
+        /// <returns>The escaped arguments, concatenated.</returns>
         public static string EscapeAndConcatenate(IEnumerable<string> args)
             => string.Join(" ", args.Select(EscapeSingleArg));
 
@@ -104,6 +104,6 @@ namespace Microsoft.Extensions.CommandLineUtils
         }
 
         private static bool ContainsWhitespace(string argument)
-            => argument.IndexOfAny(new [] { ' ', '\t', '\n' }) >= 0;
+            => argument.IndexOfAny(new[] { ' ', '\t', '\n' }) >= 0;
     }
 }