Merge branch 'main' into docs-to-learn

Author: kendaleiv

.github/policies/assign-prs.yml

@@ -5,7 +5,8 @@ resource: repository
 configuration:
   resourceManagementConfiguration:
     eventResponderTasks:
-      - if:
+      - description: Assign team PRs to author
+        if:
         - payloadType: Pull_Request
         - isAction:
             action: Opened
@@ -15,4 +16,4 @@ configuration:
         then:
         - assignTo:
             author: True
-        description: Assign team PRs to author
+

.github/policies/author-action.yml

@@ -5,15 +5,17 @@ resource: repository
 configuration:
   resourceManagementConfiguration:
     eventResponderTasks:
-      - if:
+      - description: Needs-author-action notification
+        if:
         - payloadType: Issues
         - labelAdded:
             label: needs-author-action
         then:
         - addReply:
-            reply: This issue has been marked `needs-author-action` and may be missing some important information.
-        description: Needs-author-action notification
-      - if:
+            reply: This issue has been marked `needs-author-action` and might be missing some important information.
+
+      - description: PR reviews with "changes requested" applies the needs-author-action label
+        if:
         - payloadType: Pull_Request_Review
         - not:
             activitySenderHasPermission:
@@ -25,8 +27,9 @@ configuration:
         then:
         - addLabel:
             label: needs-author-action
-        description: PR reviews with "changes requested" applies the needs-author-action label
-      - if:
+
+      - description: Replace `needs-author-action` label with `needs-further-triage` label when the author comments on an issue that's not "untriaged"
+        if:
         - payloadType: Issue_Comment
         - isAction:
             action: Created
@@ -43,8 +46,9 @@ configuration:
             label: needs-further-triage
         - removeLabel:
             label: needs-author-action
-        description: Replace `needs-author-action` label with `needs-further-triage` label when the author comments on an issue that is not still untriaged
-      - if:
+
+      - description: Remove `needs-author-action` label when the author comments on an `untriaged` issue
+        if:
         - payloadType: Issue_Comment
         - isAction:
             action: Created
@@ -58,8 +62,9 @@ configuration:
         then:
         - removeLabel:
             label: needs-author-action
-        description: Remove `needs-author-action` label when the author comments on an `untriaged` issue
-      - if:
+
+      - description: Pushing changes to PR branch removes the needs-author-action label
+        if:
         - payloadType: Pull_Request
         - isAction:
             action: Synchronize
@@ -68,8 +73,9 @@ configuration:
         then:
         - removeLabel:
             label: needs-author-action
-        description: Pushing changes to PR branch removes the needs-author-action label
-      - if:
+
+      - description: Author commenting in PR removes the needs-author-action label
+        if:
         - payloadType: Issue_Comment
         - isActivitySender:
             issueAuthor: True
@@ -81,8 +87,9 @@ configuration:
         then:
         - removeLabel:
             label: needs-author-action
-        description: Author commenting in PR removes the needs-author-action label
-      - if:
+
+      - description: Author responding to a PR review comment removes the needs-author-action label
+        if:
         - payloadType: Pull_Request_Review
         - isActivitySender:
             issueAuthor: True
@@ -94,4 +101,3 @@ configuration:
         then:
         - removeLabel:
             label: needs-author-action
-        description: Author responding to a pull request review comment removes the needs-author-action label

.github/policies/auto-merge.yml

@@ -1,14 +1,13 @@
-id:
 name: GitOps.PullRequestIssueManagement
 description: GitOps.PullRequestIssueManagement primitive
-owner:
 resource: repository
-disabled: false
-where:
+
 configuration:
   resourceManagementConfiguration:
     eventResponderTasks:
-    - if:
+    - description: Auto-squash-merge PRs to main labeled with auto-merge
+      triggerOnOwnActions: true
+      if:
       - payloadType: Pull_Request
       - labelAdded:
           label: ':octocat: auto-merge'
@@ -17,9 +16,10 @@ configuration:
       then:
       - enableAutoMerge:
           mergeMethod: Squash
+
+    - description: Auto-merge PRs to live labeled with auto-merge
       triggerOnOwnActions: true
-      description: Auto-squash-merge PRs to main labeled with auto-merge
-    - if:
+      if:
       - payloadType: Pull_Request
       - labelAdded:
           label: ':octocat: auto-merge'
@@ -28,26 +28,11 @@ configuration:
       then:
       - enableAutoMerge:
           mergeMethod: Merge
-      triggerOnOwnActions: true
-      description: Auto-merge PRs to live labeled with auto-merge
-    - if:
-      - payloadType: Pull_Request
-      - isAction:
-          action: Opened
-      - titleContains:
-          pattern: Merge main into live
-          isRegex: False
-      - targetsBranch:
-          branch: live
-      then:
-      - enableAutoMerge:
-          mergeMethod: Merge
-      triggerOnOwnActions: true
-      description: Auto-merge PRs to live with title "Merge main into live"
-    - if:
+
+    - description: Don't auto-merge PRs with auto-merge label removed
+      if:
       - payloadType: Pull_Request
       - labelRemoved:
           label: ':octocat: auto-merge'
       then:
       - disableAutoMerge
-      description: Don't auto-merge PRs with auto-merge label removed

.github/policies/community-contrib.yml

@@ -5,7 +5,8 @@ resource: repository
 configuration:
   resourceManagementConfiguration:
     eventResponderTasks:
-      - if:
+      - description: Label community PRs
+        if:
         - payloadType: Pull_Request
         - isAction:
             action: Opened
@@ -46,4 +47,3 @@ configuration:
         then:
         - addLabel:
             label: community-contribution
-        description: Label community PRs

.github/policies/label-prs.yml

@@ -5,17 +5,19 @@ resource: repository
 configuration:
   resourceManagementConfiguration:
     eventResponderTasks:
-    - if:
+    - description: Label publish PRs with auto-merge
+      triggerOnOwnActions: true
+      if:
       - payloadType: Pull_Request
       - isAction:
           action: Opened
+      - isActivitySender:
+          user: dotnet-policy-service[bot]
       - titleContains:
           pattern: Merge main into live
           isRegex: False
       then:
       - addLabel:
           label: ':octocat: auto-merge'
-      description: Label main to live PRs
-      triggerOnOwnActions: true
 
 

.github/policies/scheduled-pr.yml

@@ -5,7 +5,8 @@ resource: repository
 configuration:
   resourceManagementConfiguration:
     scheduledSearches:
-      - frequencies:
+      - description: Push to live branch (publish)
+        frequencies:
           - daily:
               time: 08:0
         filters: []
@@ -15,5 +16,4 @@ configuration:
               base: live
               title: Merge main into live
               body: Please don't squash-merge this PR.
-        description: Push to live branch (publish)
 

.github/policies/untriaged-label.yml

@@ -6,7 +6,8 @@ resource: repository
 configuration:
   resourceManagementConfiguration:
     eventResponderTasks:
-    - if:
+    - description: Add untriaged label to new/reopened issues without a milestone
+      if:
       - payloadType: Issues
       - isOpen
       - not:
@@ -22,8 +23,9 @@ configuration:
       then:
       - addLabel:
           label: untriaged
-      description: Add untriaged label to new/reopened issues without a milestone
-    - if:
+
+    - description: Remove untriaged label from issues when closed or added to a milestone
+      if:
       - payloadType: Issues
       - or:
         - isAction:
@@ -34,4 +36,3 @@ configuration:
       then:
       - removeLabel:
           label: untriaged
-      description: Remove untriaged label from issues when closed or added to a milestone

xml/System.CodeDom.Compiler/CompilerParameters.xml

@@ -59,9 +59,7 @@
  To specify a custom command-line arguments string to use when invoking the compilation process, set the string in the <xref:System.CodeDom.Compiler.CompilerParameters.CompilerOptions%2A> property. If a Win32 security token is required to invoke the compiler process, specify the token in the <xref:System.CodeDom.Compiler.CompilerParameters.UserToken%2A> property. To include .NET Framework resource files in the compiled assembly, add the names of the resource files to the <xref:System.CodeDom.Compiler.CompilerParameters.EmbeddedResources%2A> property. To reference .NET Framework resources in another assembly, add the names of the resource files to the <xref:System.CodeDom.Compiler.CompilerParameters.LinkedResources%2A> property. To include a Win32 resource file in the compiled assembly, specify the name of the Win32 resource file in the <xref:System.CodeDom.Compiler.CompilerParameters.Win32Resource%2A> property.  
   
 > [!NOTE]
->  This class contains a link demand and an inheritance demand at the class level that applies to all members. A <xref:System.Security.SecurityException> is thrown when either the immediate caller or the derived class does not have full-trust permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands) and [Inheritance Demands](https://learn.microsoft.com/previous-versions/dotnet/netframework-4.0/x4yx82e6(v=vs.100)).  
-  
-   
+> This class contains a link demand and an inheritance demand at the class level that applies to all members. A <xref:System.Security.SecurityException> is thrown when either the immediate caller or the derived class does not have full-trust permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands) and [Inheritance Demands](https://learn.microsoft.com/previous-versions/dotnet/netframework-4.0/x4yx82e6(v=vs.100)).
   
 ## Examples  
  The following example builds a CodeDOM source graph for a simple Hello World program.  The source is then saved to a file, compiled into an executable, and run. The `CompileCode` method illustrates how to use the <xref:System.CodeDom.Compiler.CompilerParameters> class to specify various compiler settings and options.  
@@ -290,11 +288,10 @@
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
-## Remarks  
- An <xref:System.CodeDom.Compiler.ICodeCompiler> typically includes this string on the command line when invoking a command-line compiler. By default, this property contains an empty string.  
-  
-   
-  
+## Remarks
+
+An <xref:System.CodeDom.Compiler.ICodeCompiler> typically includes this string on the command line when invoking a command-line compiler. By default, this property contains an empty string.
+
 ## Examples  
  The following example illustrates using <xref:System.CodeDom.Compiler.CompilerParameters> to specify various compiler settings and options. This code example is part of a larger example provided for the <xref:System.CodeDom.Compiler.CompilerParameters> class.  
   
@@ -304,6 +301,9 @@
   
  ]]></format>
         </remarks>
+        <related type="Article" href="/dotnet/csharp/language-reference/compiler-options/">C# compiler options</related>
+        <related type="Article" href="/dotnet/fsharp/language-reference/compiler-options">F# compiler options</related>
+        <related type="Article" href="/dotnet/visual-basic/reference/command-line-compiler/compiler-options-listed-by-category">Visual Basic compiler options</related>
       </Docs>
     </Member>
     <Member MemberName="CoreAssemblyFileName">

xml/System.IO/Directory.xml

@@ -1718,7 +1718,7 @@ The returned collection is not cached. Each call to the <xref:System.Collections
       </Parameters>
       <Docs>
         <param name="path">The relative or absolute path to the directory to search. This string is not case-sensitive.</param>
-        <param name="searchPattern">The search string to match against the names of subdirectories in <paramref name="path" />. This parameter can contain a combination of valid literal and wildcard characters, but it doesn't support regular expressions.</param>
+        <param name="searchPattern">The search string to match against the names of files and directories in <paramref name="path" />. This parameter can contain a combination of valid literal and wildcard characters, but it doesn't support regular expressions.</param>
         <param name="enumerationOptions">An object that describes the search and enumeration configuration to use.</param>
         <summary>Returns an enumerable collection of file names and directory names that match a search pattern and enumeration options in a specified path.</summary>
         <returns>An enumerable collection of file-system entries in the directory specified by <paramref name="path" />, that match the specified search pattern and the specified enumeration options.</returns>
@@ -3100,7 +3100,7 @@ The returned collection is not cached. Each call to the <xref:System.Collections
       </Parameters>
       <Docs>
         <param name="path">The relative or absolute path to the directory to search. This string is not case-sensitive.</param>
-        <param name="searchPattern">The search string to match against the names of subdirectories in <paramref name="path" />. This parameter can contain a combination of valid literal and wildcard characters, but it doesn't support regular expressions.</param>
+        <param name="searchPattern">The search string to match against the names of files in <paramref name="path" />. This parameter can contain a combination of valid literal and wildcard characters, but it doesn't support regular expressions.</param>
         <param name="enumerationOptions">An object that describes the search and enumeration configuration to use.</param>
         <summary>Returns the names of files (including their paths) that match the specified search pattern and enumeration options in the specified directory.</summary>
         <returns>An array of the full names (including paths) for the files in the specified directory that match the specified search pattern and enumeration options, or an empty array if no files are found.</returns>
@@ -3404,7 +3404,7 @@ The returned collection is not cached. Each call to the <xref:System.Collections
       </Parameters>
       <Docs>
         <param name="path">The relative or absolute path to the directory to search. This string is not case-sensitive.</param>
-        <param name="searchPattern">The search string to match against the names of file and directories in <paramref name="path" />.  This parameter can contain a combination of valid literal path and wildcard (* and ?) characters, but it doesn't support regular expressions.</param>
+        <param name="searchPattern">The search string to match against the names of files and directories in <paramref name="path" />.  This parameter can contain a combination of valid literal path and wildcard (* and ?) characters, but it doesn't support regular expressions.</param>
         <summary>Returns an array of file names and directory names that match a search pattern in a specified path.</summary>
         <returns>An array of file names and directory names that match the specified search criteria, or an empty array if no files or directories are found.</returns>
         <remarks>
@@ -3507,7 +3507,7 @@ The returned collection is not cached. Each call to the <xref:System.Collections
       </Parameters>
       <Docs>
         <param name="path">The relative or absolute path to the directory to search. This string is not case-sensitive.</param>
-        <param name="searchPattern">The search string to match against the names of subdirectories in <paramref name="path" />. This parameter can contain a combination of valid literal and wildcard characters, but it doesn't support regular expressions.</param>
+        <param name="searchPattern">The search string to match against the names of files and directories in <paramref name="path" />. This parameter can contain a combination of valid literal and wildcard characters, but it doesn't support regular expressions.</param>
         <param name="enumerationOptions">An object that describes the search and enumeration configuration to use.</param>
         <summary>Returns an array of file names and directory names that match a search pattern and enumeration options in a specified path.</summary>
         <returns>An array of file names and directory names that match the specified search pattern and enumeration options, or an empty array if no files or directories are found.</returns>