Merge pull request #10780 from dotnet/main

Merge main into live

Author: dotnet-policy-service[bot]

xml/System.Collections.Generic/OrderedDictionary`2+ValueCollection.xml

@@ -90,7 +90,7 @@
         <param name="arrayIndex">The zero-based index in <paramref name="array" /> at which copying begins.</param>
         <summary>Copies the elements of the <see cref="T:System.Collections.Generic.ICollection`1" /> to an <see cref="T:System.Array" />, starting at a particular <see cref="T:System.Array" /> index.</summary>
         <remarks>To be added.</remarks>
-        <inheritdoc />
+        <inheritdoc cref="M:System.Collections.Generic.ICollection`1.CopyTo(`0[],System.Int32)" />
       </Docs>
     </Member>
     <Member MemberName="Count">

xml/System.CommandLine.Help/TwoColumnHelpRow.xml

@@ -74,7 +74,7 @@
         <returns>
           <see langword="true" /> if the current object is equal to the <paramref name="other" /> parameter; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
-        <inheritdoc />
+        <inheritdoc cref="M:System.IEquatable`1.Equals(`0)" />
       </Docs>
     </Member>
     <Member MemberName="Equals">

xml/System.CommandLine.Parsing/Token.xml

@@ -82,7 +82,7 @@
         <returns>
           <see langword="true" /> if the current object is equal to the <paramref name="other" /> parameter; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
-        <inheritdoc />
+        <inheritdoc cref="M:System.IEquatable`1.Equals(`0)" />
       </Docs>
     </Member>
     <Member MemberName="Equals">

xml/System.CommandLine/ArgumentArity.xml

@@ -89,7 +89,7 @@
         <returns>
           <see langword="true" /> if the current object is equal to the <paramref name="other" /> parameter; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
-        <inheritdoc />
+        <inheritdoc cref="M:System.IEquatable`1.Equals(`0)" />
       </Docs>
     </Member>
     <Member MemberName="Equals">

xml/System.CommandLine/Option.xml

@@ -18,9 +18,7 @@
     </Interface>
   </Interfaces>
   <Docs>
-    <summary>
-            A symbol defining a named parameter and a value for that parameter. 
-            </summary>
+    <summary>Defines a named parameter and a value for that parameter.</summary>
     <remarks>To be added.</remarks>
     <altmember cref="T:System.CommandLine.IdentifierSymbol" />
   </Docs>

xml/System.CommandLine/Option`1.xml

@@ -71,9 +71,9 @@
       <Docs>
         <param name="aliases">To be added.</param>
         <param name="description">To be added.</param>
-        <summary>To be added.</summary>
+        <summary>Initializes a new instance of the <see cref="T:System.CommandLine.Option`1" /> class.</summary>
         <remarks>To be added.</remarks>
-        <inheritdoc />
+        <inheritdoc cref="M:System.CommandLine.Option.#ctor(System.String[],System.String,System.Type,System.Func{System.Object},System.CommandLine.ArgumentArity)" />
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -96,9 +96,9 @@
         <param name="name">To be added.</param>
         <param name="getDefaultValue">To be added.</param>
         <param name="description">To be added.</param>
-        <summary>To be added.</summary>
+        <summary>Initializes a new instance of the <see cref="T:System.CommandLine.Option`1" /> class.</summary>
         <remarks>To be added.</remarks>
-        <inheritdoc />
+        <inheritdoc cref="M:System.CommandLine.Option.#ctor(System.String,System.String,System.Type,System.Func{System.Object},System.CommandLine.ArgumentArity)" />
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -121,9 +121,9 @@
         <param name="aliases">To be added.</param>
         <param name="getDefaultValue">To be added.</param>
         <param name="description">To be added.</param>
-        <summary>To be added.</summary>
+        <summary>Initializes a new instance of the <see cref="T:System.CommandLine.Option`1" /> class.</summary>
         <remarks>To be added.</remarks>
-        <inheritdoc />
+        <inheritdoc cref="M:System.CommandLine.Option.#ctor(System.String[],System.String,System.Type,System.Func{System.Object},System.CommandLine.ArgumentArity)" />
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -148,9 +148,8 @@
         <param name="parseArgument">To be added.</param>
         <param name="isDefault">To be added.</param>
         <param name="description">To be added.</param>
-        <summary>To be added.</summary>
+        <summary>Initializes a new instance of the <see cref="T:System.CommandLine.Option`1" /> class.</summary>
         <remarks>To be added.</remarks>
-        <inheritdoc />
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -175,9 +174,8 @@
         <param name="parseArgument">To be added.</param>
         <param name="isDefault">To be added.</param>
         <param name="description">To be added.</param>
-        <summary>To be added.</summary>
+        <summary>Initializes a new instance of the <see cref="T:System.CommandLine.Option`1" /> class.</summary>
         <remarks>To be added.</remarks>
-        <inheritdoc />
       </Docs>
     </Member>
     <Member MemberName="Arity">

xml/System.Net.Http.Headers/HttpHeadersNonValidated.xml

@@ -244,7 +244,7 @@ Multiple header values associated with the same header name are considered to be
         <returns>
           <see langword="true" /> if the read-only dictionary contains an element that has the specified key; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
-        <inheritdoc />
+        <inheritdoc cref="M:System.Collections.Generic.IReadOnlyDictionary`2.ContainsKey(`0)" />
       </Docs>
     </Member>
     <Member MemberName="System.Collections.Generic.IReadOnlyDictionary&lt;System.String,System.Net.Http.Headers.HeaderStringValues&gt;.Keys">
@@ -304,7 +304,7 @@ Multiple header values associated with the same header name are considered to be
         <returns>
           <see langword="true" /> if the collection contains the specified header; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
-        <inheritdoc />
+        <inheritdoc cref="M:System.Collections.Generic.IReadOnlyDictionary`2.TryGetValue(`0,`1@)" />
       </Docs>
     </Member>
     <Member MemberName="System.Collections.Generic.IReadOnlyDictionary&lt;System.String,System.Net.Http.Headers.HeaderStringValues&gt;.Values">

xml/System.Security.Cryptography.Cose/CoseHeaderMap.xml

@@ -295,7 +295,7 @@
         <returns>
           <see langword="true" /> if <paramref name="item" /> is found in the <see cref="T:System.Collections.Generic.ICollection`1" />; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
-        <inheritdoc />
+        <inheritdoc cref="M:System.Collections.Generic.ICollection`1.Contains(`0)" />
       </Docs>
     </Member>
     <Member MemberName="ContainsKey">
@@ -326,7 +326,7 @@
         <returns>
           <see langword="true" /> if the <see cref="T:System.Collections.Generic.IDictionary`2" /> contains an element with the key; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
-        <inheritdoc />
+        <inheritdoc cref="M:System.Collections.Generic.IDictionary`2.ContainsKey(`0)" />
       </Docs>
     </Member>
     <Member MemberName="CopyTo">
@@ -363,7 +363,7 @@
         <param name="arrayIndex">The zero-based index in <paramref name="array" /> at which copying begins.</param>
         <summary>Copies the elements of the <see cref="T:System.Collections.Generic.ICollection`1" /> to an <see cref="T:System.Array" />, starting at a particular <see cref="T:System.Array" /> index.</summary>
         <remarks>To be added.</remarks>
-        <inheritdoc />
+        <inheritdoc cref="M:System.Collections.Generic.ICollection`1.CopyTo(`0[],System.Int32)" />
       </Docs>
     </Member>
     <Member MemberName="Count">
@@ -801,7 +801,7 @@ This member is an explicit interface member implementation. It can be used only
         <summary>To be added.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
-        <inheritdoc />
+        <inheritdoc cref="M:System.Collections.Generic.IDictionary`2.TryGetValue(`0,`1@)" />
       </Docs>
     </Member>
     <Member MemberName="Values">