Merge pull request #10296 from dotnet/main

Merge main into live

Author: dotnet-policy-service[bot]

xml/System.IO.Pipelines/PipeReader.xml

@@ -296,7 +296,7 @@ The canceled <xref:System.IO.Pipelines.PipeReader.ReadAsync(System.Threading.Can
       <Docs>
         <param name="destination">The pipe writer to which the contents of the current stream will be copied.</param>
         <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None" />.</param>
-        <summary>Asynchronously reads the bytes from the <see cref="T:System.IO.Pipelines.PipeReader" /> and writes them to the specified <see cref="T:System.IO.Pipelines.PipeWriter" />, using a specified buffer size and cancellation token.</summary>
+        <summary>Asynchronously reads the bytes from the <see cref="T:System.IO.Pipelines.PipeReader" /> and writes them to the specified <see cref="T:System.IO.Pipelines.PipeWriter" />, using a specified cancellation token.</summary>
         <returns>A task that represents the asynchronous copy operation.</returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.OperationCanceledException">The cancellation token was canceled. This exception is stored into the returned task.</exception>

xml/System.Runtime.InteropServices/SafeHandle.xml

@@ -101,7 +101,7 @@ Optionally specify `-Fault` to intentionally attempt to leak the handle by abort
       ]]></format>
     </example>
     <block subset="none" type="overrides">
-      <para>To create a class derived from <see cref="T:System.Runtime.InteropServices.SafeHandle" />, you must know how to create and free an operating system handle. This process is different for different handle types because some use the [CloseHandle](/windows/win32/api/handleapi/nf-handleapi-closehandle) function, while others use more specific functions such as [UnmapViewOfFile](/windows/win32/api/memoryapi/nf-memoryapi-unmapviewoffile) or [FindClose](/windows/win32/api/fileapi/nf-fileapi-findclose). For this reason, you must create a derived class of <see cref="T:System.Runtime.InteropServices.SafeHandle" /> for each operating system handle type that you want to wrap in a safe handle.</para>
+      <para>To create a class derived from <see cref="T:System.Runtime.InteropServices.SafeHandle" />, you must know how to create and free an operating system handle. This process is different for different handle types because some use the <see href="/windows/win32/api/handleapi/nf-handleapi-closehandle">CloseHandle</see> function, while others use more specific functions such as <see href="/windows/win32/api/memoryapi/nf-memoryapi-unmapviewoffile">UnmapViewOfFile</see> or <see href="/windows/win32/api/fileapi/nf-fileapi-findclose">FindClose</see>. For this reason, you must create a derived class of <see cref="T:System.Runtime.InteropServices.SafeHandle" /> for each operating system handle type that you want to wrap in a safe handle.</para>
       <para>When you inherit from <see cref="T:System.Runtime.InteropServices.SafeHandle" />, you must override the following members: <see cref="P:System.Runtime.InteropServices.SafeHandle.IsInvalid" /> and <see cref="M:System.Runtime.InteropServices.SafeHandle.ReleaseHandle" />.</para>
       <para>You should also provide a public parameterless constructor that calls the base constructor with a value that represents an invalid handle value, and a <see cref="T:System.Boolean" /> value indicating whether the native handle is owned by the <see cref="T:System.Runtime.InteropServices.SafeHandle" /> and consequently should be freed when that <see cref="T:System.Runtime.InteropServices.SafeHandle" /> has been disposed.</para>
     </block>

xml/System.Windows.Input/KeyConverter.xml

@@ -56,7 +56,7 @@
       </Attributes>
       <Parameters />
       <Docs>
-        <summary>Initializes a new instance of the <see cref="T:System.Windows.Input.Key" /> class.</summary>
+        <summary>Initializes a new instance of the <see cref="T:System.Windows.Input.KeyConverter" /> class.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System/DateOnly.xml

@@ -1431,7 +1431,15 @@
         <param name="time">The time of the day.</param>
         <summary>Returns a <see cref="T:System.DateTime" /> that is set to the date of this <see cref="T:System.DateOnly" /> instance and the time of specified input time.</summary>
         <returns>The <see cref="T:System.DateTime" /> instance composed of the date of the current <see cref="T:System.DateOnly" /> instance and the time specified by the input time.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+The <xref:System.DateTime.Kind> property of the resulting <xref:System.DateTime> is initialized to <xref:System.DateTimeKind.Unspecified?displayProperty=nameWithType>.
+            
+]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="ToDateTime">