Merge main into live

.github/policies/disallow-edits.yml

@@ -3,39 +3,49 @@ description: GitOps.PullRequestIssueManagement primitive
 resource: repository
 
 configuration:
-  resourceManagementConfiguration:
-    eventResponderTasks:
-      - description: Close PRs that modify files whose "source of truth" is not in this repo.
-        if:
-          - payloadType: Pull_Request
-          - isAction:
-              action: Opened
-          - or:
-              - filesMatchPattern:
-                  pattern: xml/Microsoft.Extensions*/*.xml
-                  excludedFiles: # These files use this repo as source-of-truth.
-                    - xml/Microsoft.Extensions.FileSystemGlobbing/*.xml
-                    - xml/Microsoft.Extensions.FileSystemGlobbing.Abstractions/*.xml
-                    - xml/Microsoft.Extensions.FileSystemGlobbing.Internal*/*.xml
-              - filesMatchPattern:
-                  pattern: xml/System.Composition/*.xml
-              - filesMatchPattern:
-                  pattern: xml/System.Formats.Cbor/*.xml
-              - filesMatchPattern:
-                  pattern: xml/System.Formats.Nrbf/*.xml
-              - filesMatchPattern:
-                  pattern: xml/System.Net.ServerSentEvents/*.xml
-              - filesMatchPattern:
-                  pattern: xml/System.Numerics.Tensors/*.xml
-              - filesMatchPattern:
-                  pattern: xml/System.Speech/*.xml
-              - includesModifiedFile:
-                  file: xml/System.Runtime.Serialization/ISerializationCodeDomSurrogateProvider.xml
-              - includesModifiedFile:
-                  file: xml/System.Runtime.Serialization/ImportOptions.xml
-              - includesModifiedFile:
-                  file: xml/System.Runtime.Serialization/XsdDataContractExporter.xml
-        then:
-          - addReply:
-              reply: "@${issueAuthor} This PR will be closed because it edits files whose 'source of truth' is not in the repo."
-          - closePullRequest
+    resourceManagementConfiguration:
+        eventResponderTasks:
+            - description: Close PRs that modify files whose "source of truth" is not in this repo.
+              if:
+                  - payloadType: Pull_Request
+                  - isAction:
+                        action: Opened
+                  - or:
+                        - includesModifiedFiles:
+                              files:
+                                  - xml/Microsoft.Extensions*/*
+                              excludedFiles:
+                                  # These files use this repo as source-of-truth.
+                                  - xml/Microsoft.Extensions.FileSystemGlobbing/*
+                                  - xml/Microsoft.Extensions.FileSystemGlobbing.Abstractions/*
+                                  - xml/Microsoft.Extensions.FileSystemGlobbing.Internal*/*
+                        - includesModifiedFiles:
+                              files:
+                                  - xml/System.Composition
+                        - includesModifiedFiles:
+                              files:
+                                  - xml/System.Formats.Cbor
+                        - includesModifiedFiles:
+                              files:
+                                  - xml/System.Formats.Nrbf
+                        - includesModifiedFiles:
+                              files:
+                                  - xml/System.Net.ServerSentEvents
+                        - includesModifiedFiles:
+                              files:
+                                  - xml/System.Numerics.Tensors
+                        - includesModifiedFiles:
+                              files:
+                                  - xml/System.Speech
+                        - includesModifiedFile:
+                              file: xml/System.Runtime.Serialization/ISerializationCodeDomSurrogateProvider.xml
+                        - includesModifiedFile:
+                              file: xml/System.Runtime.Serialization/ImportOptions.xml
+                        - includesModifiedFile:
+                              file: xml/System.Runtime.Serialization/XsdDataContractExporter.xml
+              then:
+                  - addReply:
+                        reply: >-
+                            Hello @${issueAuthor},
+
+                            This PR will be closed because it edits files whose 'source of truth' is not in the repo.

docfx.json

@@ -147,16 +147,16 @@
         "api/**.yml": ["csharp", "vb", "fsharp", "cpp"]
       },
       "open_to_public_contributors": {
-        "xml/Microsoft.Extensions*/*.xml": false,
-        "xml/System.Composition/*.xml": false,
-        "xml/System.Formats.Cbor/*.xml": false,
-        "xml/System.Formats.Nrbf/*.xml": false,
-        "xml/System.Net.ServerSentEvents/*.xml": false,
-        "xml/System.Numerics.Tensors/*.xml": false,
-        "xml/System.Runtime.Serialization/ISerializationCodeDomSurrogateProvider.xml": false,
-        "xml/System.Runtime.Serialization/ImportOptions.xml": false,
-        "xml/System.Runtime.Serialization/XsdDataContractExporter.xml": false,
-        "xml/System.Speech*/*.xml": false
+        "api/Microsoft.Extensions**": false,
+        "api/System.Composition**": false,
+        "api/System.Formats.Cbor**": false,
+        "api/System.Formats.Nrbf**": false,
+        "api/System.Net.ServerSentEvents**": false,
+        "api/System.Numerics.Tensors**": false,
+        "api/System.Runtime.Serialization.ISerializationCodeDomSurrogateProvider.yml": false,
+        "api/System.Runtime.Serialization.ImportOptions.yml": false,
+        "api/System.Runtime.Serialization.XsdDataContractExporter.yml": false,
+        "api/System.Speech**": false
       }
     },
     "dest": "_site",

xml/System.Diagnostics/DebuggerDisableUserUnhandledExceptionsAttribute.xml

@@ -68,7 +68,7 @@
       </AssemblyInfo>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.DebuggerDisableUserUnhandledExceptionsAttribute"/> class.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.IO/File.xml

@@ -345,8 +345,8 @@
           <para>Asynchronously appends the specified byte array to the end of the file at the given path.</para>
           <para>If the file doesn't exist, this method creates a new file. If the operation is canceled, the task will return in a canceled state.</para>
         </summary>
-        <returns>To be added.</returns>
-        <remarks>A task that represents the asynchronous append operation.</remarks>
+        <returns>A task that represents the asynchronous append operation.</returns>
+        <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="path" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">