Merge branch 'dotnet:main' into main

Author: bigboybamo

.github/ISSUE_TEMPLATE/02-breaking-change.yml

@@ -23,12 +23,15 @@ body:
       options:
         - .NET 8
         - .NET 9
-        - .NET 10 Preview 1
-        - .NET 10 Preview 2
-        - .NET 10 Preview 3
         - .NET 10 Preview 4
         - .NET 10 Preview 5
         - .NET 10 Preview 6
+        - .NET 10 Preview 7
+        - .NET 10 RC 1
+        - .NET 10 RC 2
+        - .NET 10 GA
+        - .NET 11 Preview 1
+        - .NEt 11 Preview 2
         - Other (please put exact version in description textbox)
     validations:
       required: true

.github/copilot-instructions.md

@@ -1,3 +1,5 @@
+When you're assigned an issue, after you've completed your work and the workflows (status checks) have run, check to make sure there are no build warnings under the OpenPublishing.Build status check. If there are, open the build report (under View Details) and resolve any build warnings you introduced.
+
 When writing documentation, follow the following guidelines:
 
 Unless otherwise specified, all .NET content refers to modern .NET (not .NET Framework).
@@ -24,7 +26,9 @@ Use "might" instead of "may" to indicate possibility. For example, "This method
 
 Use the Oxford comma in lists of three or more items.
 
-Number ordered list items all as "1." instead of "1.", "2.", etc. Use bullets for unordered lists.
+Number ordered list items all as "1." instead of "1.", "2.", etc.
+
+Use bullets for unordered lists. Unless *all* the bullet list items are three words or less, each bullet item should end with a period.
 
 Use **bold** when referring to UI elements. Use `code style` for file names and folders, custom types, and other text that should never be localized.
 

.github/dependabot.yml

@@ -933,7 +933,7 @@ updates:
         patterns:
           - "*" # Prefer a single PR per project update.
   - package-ecosystem: "nuget"
-    directory: "/docs/ai/quickstarts/snippets/mcp-server" #MinimalMcpServer.csproj
+    directory: "/docs/ai/quickstarts/snippets/mcp-server" #SampleMcpServer.csproj
     schedule:
       interval: "weekly"
       day: "wednesday"
@@ -1361,6 +1361,17 @@ updates:
       dotnet:
         patterns:
           - "*" # Prefer a single PR per project update.
+  - package-ecosystem: "nuget"
+    directory: "/docs/core/diagnostics/snippets/resource-monitoring-with-manual-metrics" #resource-monitoring-with-manual-metrics.csproj
+    schedule:
+      interval: "weekly"
+      day: "wednesday"
+    open-pull-requests-limit: 5
+    groups:
+      # Group .NET updates together for projects.
+      dotnet:
+        patterns:
+          - "*" # Prefer a single PR per project update.
   - package-ecosystem: "nuget"
     directory: "/docs/core/diagnostics/snippets/resource-monitoring" #resource-monitoring.csproj
     schedule:
@@ -2186,14 +2197,3 @@ updates:
       dotnet:
         patterns:
           - "*" # Prefer a single PR per project update.
-  - package-ecosystem: "nuget"
-    directory: "/docs/core/resilience/snippets/resilience" #resilience.csproj
-    schedule:
-      interval: "weekly"
-      day: "wednesday"
-    open-pull-requests-limit: 5
-    groups:
-      # Group .NET updates together for projects.
-      dotnet:
-        patterns:
-          - "*" # Prefer a single PR per project update.

.github/policies/label-issues.yml

@@ -31,14 +31,12 @@ configuration:
                 * 'needs-more-info' label removed
               if:
                 - payloadType: Issues
-                - or:
-                
+                - or:                
                   - or:
                     - isAction: 
                         action: Opened
                     - isAction: 
-                        action: Reopened
-                        
+                        action: Reopened                        
                   - labelRemoved:
                       label: 'needs-more-info'
               then:
@@ -57,8 +55,7 @@ configuration:
                     - isAction: 
                         action: Closed
                     - isActivitySender:
-                        issueAuthor: true
-                  
+                        issueAuthor: true                  
                   - labelAdded: 
                       label: ':world_map: reQUEST'
               then:
@@ -71,7 +68,6 @@ configuration:
                 - or:
                   - payloadType: Issues
                   - payloadType: Pull_Request
-
                 - labelAdded:
                     label: ':world_map: mapQUEST'
               then:
@@ -97,8 +93,7 @@ configuration:
                 - isAction: 
                     action: Reopened
                 - hasLabel:
-                    label: "won't fix"
-                  
+                    label: "won't fix"                  
               then:
                 - removeLabel:
                    label: "won't fix"
@@ -109,8 +104,7 @@ configuration:
                 - isAction: 
                     action: Closed
                 - hasLabel:
-                    label: 'in-progress'
-                  
+                    label: 'in-progress'                  
               then:
                 - removeLabel:
                    label: 'in-progress'
@@ -122,7 +116,9 @@ configuration:
                     action: Closed
                 - isActivitySender:
                     issueAuthor: true
-
+                - not:
+                    activitySenderHasAssociation:
+                        association: Member
               then:
                 - addLabel:
                    label: resolved-by-customer

.github/prompts/whats-new-net.md

@@ -0,0 +1,44 @@
+When you're assigned an issue where one label includes the word "Release" and you're given a link to an issue with this prompt file as context to update the what's new in .NET pages, follow these guidelines:
+
+## Task
+
+You'll update 4 articles. For .NET 10, you update these:
+
+- https://github.com/dotnet/docs/blob/main/docs/core/whats-new/dotnet-10/overview.md
+- https://github.com/dotnet/docs/blob/main/docs/core/whats-new/dotnet-10/runtime.md
+- https://github.com/dotnet/docs/blob/main/docs/core/whats-new/dotnet-10/libraries.md
+- https://github.com/dotnet/docs/blob/main/docs/core/whats-new/dotnet-10/sdk.md
+
+For other releases, replace "dotnet-10" in the preceding paths with the correct release. For example, use "dotnet-11" for the ".NET 11" releases.
+
+## Source material
+
+To learn what's new in the targeted release, use the corresponding release notes in the [dotnet core](https://github.com/dotnet/core) repository. The release notes will be in a subfolder of the "release-notes" folder.
+
+For production releases, the path is `<major-release>/<release-number>`, where:
+
+- `<major-release>` is the release number. For example, `8.0`, `9.0` or `10.0`.
+- `<minor-release>` is the three part release number. For example, `8.0.3`, `9.0.6` or `10.0.0`.
+
+For preview releases, the path is `<major-release>/preview/preview<n>` where:
+
+- `<major-release>` is the release number. For example, `8.0`, `9.0` or `10.0`.
+- `n` is the preview number. For example, `1`, `3`, or `6`.
+
+The primary release notes are in the `README.MD` file in that folder.  That file contains links to other release notes for components of .NET: libraries, runtime, SDK, languages, and so on. Use all that information for source.
+
+## Updates for each file
+
+- Each file should have its `ms.date` metadata field updated to match the date you're assigned the issue.
+- Ensure each file has the `ai-usage: ai-assisted` metadata field added.
+- Update phrasing on the latest update to reference the current release (preview, GA, or service release). Individual features shouldn't reference a given preview release, but the article should make it clear which was the last preview.
+- Search this repository for articles that have been recently updated pertaining to new features. Add links to those as you write about that feature. Or, add applicable information from the release notes into existing feature articles where it makes sense.
+- For the runtime and libraries articles, include extensive examples as well as links to recently updated articles related to the new feature. The examples should be at least as thorough as the examples from the source release notes.
+- Where applicable, the SDK article should include the samples.
+- The overview article generally doesn't include examples. Its purpose is to direct readers to more detailed information in other articles.
+- All APIs should be referenced using an `xref` style link, at least on first mention.
+- All links to article in the `dotnet/docs` repository should be file relative.
+- Spell out acronyms on first use in each file.
+- In general, don't mention specific contributors or pull requests to the product repos.
+
+Next, create a pull request. In the description, include the text "Fixes #\<issue-number>", where "issue-number" is the GitHub issue number.

.github/workflows/check-for-build-warnings.yml

@@ -16,7 +16,7 @@ jobs:
         pull-requests: write
     steps:
     - name: Harden Runner
-      uses: step-security/harden-runner@6c439dc8bdf85cadbbce9ed30d1c7b959517bc49 # v2.12.2
+      uses: step-security/harden-runner@ec9f2d5744a09debf3a187a3f4f675c53b671911 # v2.13.0
       with:
         egress-policy: audit
 

.github/workflows/cleanrepo-orphaned-articles.yml

@@ -17,7 +17,7 @@ jobs:
 
     steps:
       - name: Harden Runner
-        uses: step-security/harden-runner@6c439dc8bdf85cadbbce9ed30d1c7b959517bc49 # v2.12.2
+        uses: step-security/harden-runner@ec9f2d5744a09debf3a187a3f4f675c53b671911 # v2.13.0
         with:
           egress-policy: audit
 

.github/workflows/cleanrepo-orphaned-images.yml

@@ -17,7 +17,7 @@ jobs:
 
     steps:
       - name: Harden Runner
-        uses: step-security/harden-runner@6c439dc8bdf85cadbbce9ed30d1c7b959517bc49 # v2.12.2
+        uses: step-security/harden-runner@ec9f2d5744a09debf3a187a3f4f675c53b671911 # v2.13.0
         with:
           egress-policy: audit
 

.github/workflows/cleanrepo-orphaned-includes.yml

@@ -17,7 +17,7 @@ jobs:
 
     steps:
       - name: Harden Runner
-        uses: step-security/harden-runner@6c439dc8bdf85cadbbce9ed30d1c7b959517bc49 # v2.12.2
+        uses: step-security/harden-runner@ec9f2d5744a09debf3a187a3f4f675c53b671911 # v2.13.0
         with:
           egress-policy: audit
 

.github/workflows/cleanrepo-orphaned-snippets.yml

@@ -17,7 +17,7 @@ jobs:
 
     steps:
       - name: Harden Runner
-        uses: step-security/harden-runner@6c439dc8bdf85cadbbce9ed30d1c7b959517bc49 # v2.12.2
+        uses: step-security/harden-runner@ec9f2d5744a09debf3a187a3f4f675c53b671911 # v2.13.0
         with:
           egress-policy: audit