Skip to content

Commit 496fcc0

Browse files
Merge pull request #49878 from dotnet/main
Merge main into live
2 parents 982c98e + c9f70d2 commit 496fcc0

File tree

104 files changed

+366
-324
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

104 files changed

+366
-324
lines changed
Lines changed: 83 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,83 @@
1+
---
2+
name: breakingchange-creator
3+
description: Agent that specializes in creating breaking change articles
4+
---
5+
6+
You are a documentation specialist focused on breaking change articles. Focus on the following instructions:
7+
8+
- Use Markdown format.
9+
- Document ONLY modern .NET breaking changes. That is, ignore docs under [`docs/framework/migration-guide`](https://github.com/dotnet/docs/tree/main/docs/framework/migration-guide) (which are for legacy .NET Framework).
10+
- Make content clear and concise.
11+
- In addition to adding the new article, update any related articles that describe or use the affected feature or API to mention the new behavior.
12+
13+
## Document structure
14+
15+
Start with this header (replace placeholders):
16+
17+
```
18+
---
19+
title: "Breaking change - <Concise descriptive title>"
20+
description: "Learn about the breaking change in <product/version without preview> where <brief description>."
21+
ms.date: <Today's date in MM/DD/YYYY format>
22+
ai-usage: ai-assisted
23+
---
24+
```
25+
26+
> **Note:** Use today's date in the format MM/DD/YYYY. This date cannot be earlier than 11/12/2025.
27+
28+
Then, include these sections in this order:
29+
30+
### 1. H1 Title
31+
32+
- Use the header title, but remove "Breaking change - ".
33+
34+
**Intro paragraph:**
35+
Summarize the breaking change.
36+
37+
### 2. Version introduced
38+
39+
- Version where change was introduced (include preview number if applicable).
40+
41+
### 3. Previous behavior
42+
43+
- Briefly describe past behavior using past tense.
44+
- Start the first sentence with "Previously, ...".
45+
- Include example code snippets if relevant.
46+
47+
### 4. New behavior
48+
49+
- Briefly describe new behavior using present tense.
50+
- Start the first sentence with "Starting in <major version>, ..."
51+
- Include example code snippets if relevant.
52+
53+
### 5. Type of breaking change
54+
55+
- If **behavioral change**:
56+
`This change is a [behavioral change](../../categories.md#behavioral-change).`
57+
- If **source or binary incompatible**:
58+
`This change can affect [source compatibility](../../categories.md#source-incompatible) and/or [binary compatibility](../../categories.md#binary-incompatible).`
59+
60+
### 6. Reason for change
61+
62+
- Explain why the change was made.
63+
- Include relevant links.
64+
65+
### 7. Recommended action
66+
67+
- Describe what users should do to adapt.
68+
- Include code examples if helpful.
69+
70+
### 8. Affected APIs
71+
72+
- Bullet list of affected APIs.
73+
- Use **xref-style links** as described in `copilot-instructions.md`.
74+
- If none: Write "None."
75+
76+
## Final steps
77+
78+
- Add the new doc to the [TOC file](https://github.com/dotnet/docs/blob/main/docs/core/compatibility/toc.yml).
79+
- Add an entry to the index file (for example, https://github.com/dotnet/docs/blob/main/docs/core/compatibility/10.0.md for .NET 10 breaking changes) under the appropriate area H2 heading.
80+
- Create a pull request:
81+
- In the description, include: `Fixes #<issue-number>` (replace with the correct number).
82+
- Request review on the pull request from the person who opened the issue.
83+
- Also check the relevant API docs, if applicable, and update them in the https://github.com/dotnet/dotnet-api-docs repo to reflect the breaking change.

.github/workflows/dependency-review.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,4 +24,4 @@ jobs:
2424
- name: 'Checkout Repository'
2525
uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
2626
- name: 'Dependency Review'
27-
uses: actions/dependency-review-action@40c09b7dc99638e5ddb0bfd91c1673effc064d8a # v4.8.1
27+
uses: actions/dependency-review-action@3c4e3dcb1aa7874d2c16be7d79418e9b7efd6261 # v4.8.2

.openpublishing.redirection.standard.json

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,10 @@
5858
"source_path_from_root": "/docs/standard/base-types/backtracking.md",
5959
"redirect_url": "/dotnet/standard/base-types/backtracking-in-regular-expressions"
6060
},
61+
{
62+
"source_path_from_root": "/docs/standard/base-types/basic-string-operations.md",
63+
"redirect_url": "/dotnet/standard/base-types/creating-new"
64+
},
6165
{
6266
"source_path_from_root": "/docs/standard/base-types/best-practices.md",
6367
"redirect_url": "/dotnet/standard/base-types/best-practices-regex"

docs/ai/evaluation/snippets/evaluate-ai-responses/TestAI.csproj

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -11,14 +11,14 @@
1111
<ItemGroup>
1212
<PackageReference Include="Azure.AI.OpenAI" Version="2.1.0" />
1313
<PackageReference Include="Azure.Identity" Version="1.17.0" />
14-
<PackageReference Include="Microsoft.Extensions.AI.Abstractions" Version="9.10.2" />
15-
<PackageReference Include="Microsoft.Extensions.AI.Evaluation" Version="9.10.0" />
16-
<PackageReference Include="Microsoft.Extensions.AI.Evaluation.Quality" Version="9.10.0" />
14+
<PackageReference Include="Microsoft.Extensions.AI.Abstractions" Version="10.0.0" />
15+
<PackageReference Include="Microsoft.Extensions.AI.Evaluation" Version="10.0.0" />
16+
<PackageReference Include="Microsoft.Extensions.AI.Evaluation.Quality" Version="10.0.0" />
1717
<PackageReference Include="Microsoft.Extensions.AI.OpenAI" Version="9.4.0-preview.1.25207.5" />
18-
<PackageReference Include="Microsoft.Extensions.Configuration" Version="9.0.10" />
19-
<PackageReference Include="Microsoft.Extensions.Configuration.UserSecrets" Version="9.0.10" />
20-
<PackageReference Include="Microsoft.NET.Test.Sdk" Version="18.0.0" />
21-
<PackageReference Include="MSTest" Version="4.0.1" />
18+
<PackageReference Include="Microsoft.Extensions.Configuration" Version="10.0.0" />
19+
<PackageReference Include="Microsoft.Extensions.Configuration.UserSecrets" Version="10.0.0" />
20+
<PackageReference Include="Microsoft.NET.Test.Sdk" Version="18.0.1" />
21+
<PackageReference Include="MSTest" Version="4.0.2" />
2222
</ItemGroup>
2323

2424
<ItemGroup>

docs/ai/evaluation/snippets/evaluate-safety/EvaluateResponseSafety.csproj

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -11,15 +11,15 @@
1111
<ItemGroup>
1212
<PackageReference Include="Azure.AI.OpenAI" Version="2.1.0" />
1313
<PackageReference Include="Azure.Identity" Version="1.17.0" />
14-
<PackageReference Include="Microsoft.Extensions.AI.Abstractions" Version="9.10.2" />
15-
<PackageReference Include="Microsoft.Extensions.AI.Evaluation" Version="9.10.0" />
16-
<PackageReference Include="Microsoft.Extensions.AI.Evaluation.Reporting" Version="9.10.0" />
14+
<PackageReference Include="Microsoft.Extensions.AI.Abstractions" Version="10.0.0" />
15+
<PackageReference Include="Microsoft.Extensions.AI.Evaluation" Version="10.0.0" />
16+
<PackageReference Include="Microsoft.Extensions.AI.Evaluation.Reporting" Version="10.0.0" />
1717
<PackageReference Include="Microsoft.Extensions.AI.Evaluation.Safety" Version="9.5.0-preview.1.25265.7" />
1818
<PackageReference Include="Microsoft.Extensions.AI.OpenAI" Version="9.5.0-preview.1.25265.7" />
19-
<PackageReference Include="Microsoft.Extensions.Configuration" Version="9.0.10" />
20-
<PackageReference Include="Microsoft.Extensions.Configuration.UserSecrets" Version="9.0.10" />
21-
<PackageReference Include="Microsoft.NET.Test.Sdk" Version="18.0.0" />
22-
<PackageReference Include="MSTest" Version="4.0.1" />
19+
<PackageReference Include="Microsoft.Extensions.Configuration" Version="10.0.0" />
20+
<PackageReference Include="Microsoft.Extensions.Configuration.UserSecrets" Version="10.0.0" />
21+
<PackageReference Include="Microsoft.NET.Test.Sdk" Version="18.0.1" />
22+
<PackageReference Include="MSTest" Version="4.0.2" />
2323
</ItemGroup>
2424

2525
<ItemGroup>

docs/ai/evaluation/snippets/evaluate-with-reporting/TestAIWithReporting.csproj

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -11,15 +11,15 @@
1111
<ItemGroup>
1212
<PackageReference Include="Azure.AI.OpenAI" Version="2.1.0" />
1313
<PackageReference Include="Azure.Identity" Version="1.17.0" />
14-
<PackageReference Include="Microsoft.Extensions.AI.Abstractions" Version="9.10.1" />
15-
<PackageReference Include="Microsoft.Extensions.AI.Evaluation" Version="9.10.0" />
16-
<PackageReference Include="Microsoft.Extensions.AI.Evaluation.Quality" Version="9.10.0" />
17-
<PackageReference Include="Microsoft.Extensions.AI.Evaluation.Reporting" Version="9.10.0" />
14+
<PackageReference Include="Microsoft.Extensions.AI.Abstractions" Version="10.0.0" />
15+
<PackageReference Include="Microsoft.Extensions.AI.Evaluation" Version="10.0.0" />
16+
<PackageReference Include="Microsoft.Extensions.AI.Evaluation.Quality" Version="10.0.0" />
17+
<PackageReference Include="Microsoft.Extensions.AI.Evaluation.Reporting" Version="10.0.0" />
1818
<PackageReference Include="Microsoft.Extensions.AI.OpenAI" Version="9.4.3-preview.1.25230.7" />
19-
<PackageReference Include="microsoft.extensions.configuration" Version="9.0.10" />
20-
<PackageReference Include="Microsoft.Extensions.Configuration.UserSecrets" Version="9.0.10" />
21-
<PackageReference Include="Microsoft.NET.Test.Sdk" Version="18.0.0" />
22-
<PackageReference Include="MSTest" Version="4.0.1" />
19+
<PackageReference Include="microsoft.extensions.configuration" Version="10.0.0" />
20+
<PackageReference Include="Microsoft.Extensions.Configuration.UserSecrets" Version="10.0.0" />
21+
<PackageReference Include="Microsoft.NET.Test.Sdk" Version="18.0.1" />
22+
<PackageReference Include="MSTest" Version="4.0.2" />
2323
</ItemGroup>
2424

2525
<ItemGroup>

docs/ai/how-to/snippets/hosted-app-auth/hosted-app-auth.csproj

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,8 +10,8 @@
1010
<ItemGroup>
1111
<PackageReference Include="Azure.AI.OpenAI" Version="2.1.0" />
1212
<PackageReference Include="Azure.Identity" Version="1.17.0" />
13-
<PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="9.0.10" />
14-
<PackageReference Include="Microsoft.Extensions.AI" Version="9.10.1" />
13+
<PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="9.0.11" />
14+
<PackageReference Include="Microsoft.Extensions.AI" Version="10.0.0" />
1515
<PackageReference Include="Microsoft.Extensions.AI.OpenAI" Version="9.4.0-preview.1.25207.5" />
1616
<PackageReference Include="Microsoft.Extensions.Azure" Version="1.13.0" />
1717
</ItemGroup>

docs/ai/quickstarts/snippets/structured-output/SOChat.csproj

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -11,10 +11,10 @@
1111
<ItemGroup>
1212
<PackageReference Include="Azure.AI.OpenAI" Version="2.1.0" />
1313
<PackageReference Include="Azure.Identity" Version="1.17.0" />
14-
<PackageReference Include="Microsoft.Extensions.AI" Version="9.10.1" />
14+
<PackageReference Include="Microsoft.Extensions.AI" Version="10.0.0" />
1515
<PackageReference Include="Microsoft.Extensions.AI.OpenAI" Version="9.4.0-preview.1.25207.5" />
16-
<PackageReference Include="Microsoft.Extensions.Configuration" Version="9.0.10" />
17-
<PackageReference Include="Microsoft.Extensions.Configuration.UserSecrets" Version="9.0.10" />
16+
<PackageReference Include="Microsoft.Extensions.Configuration" Version="10.0.0" />
17+
<PackageReference Include="Microsoft.Extensions.Configuration.UserSecrets" Version="10.0.0" />
1818
</ItemGroup>
1919

2020
</Project>

docs/ai/snippets/microsoft-extensions-ai/AI.Shared/AI.Shared.csproj

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,8 +7,8 @@
77
</PropertyGroup>
88

99
<ItemGroup>
10-
<PackageReference Include="Microsoft.Extensions.AI" Version="9.10.2" />
11-
<PackageReference Include="System.Threading.RateLimiting" Version="10.0.0-rc.2.25502.107" />
10+
<PackageReference Include="Microsoft.Extensions.AI" Version="10.0.0" />
11+
<PackageReference Include="System.Threading.RateLimiting" Version="10.0.0" />
1212
</ItemGroup>
1313

1414
</Project>

docs/ai/snippets/microsoft-extensions-ai/ConsoleAI.DependencyInjection/ConsoleAI.DependencyInjection.csproj

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,9 +8,9 @@
88
</PropertyGroup>
99

1010
<ItemGroup>
11-
<PackageReference Include="OllamaSharp" Version="5.4.8" />
12-
<PackageReference Include="Microsoft.Extensions.Hosting" Version="10.0.0-rc.2.25502.107" />
13-
<PackageReference Include="Microsoft.Extensions.Caching.Memory" Version="10.0.0-rc.2.25502.107" />
11+
<PackageReference Include="OllamaSharp" Version="5.4.10" />
12+
<PackageReference Include="Microsoft.Extensions.Hosting" Version="10.0.0" />
13+
<PackageReference Include="Microsoft.Extensions.Caching.Memory" Version="10.0.0" />
1414
<ProjectReference Include="..\AI.Shared\AI.Shared.csproj" />
1515
</ItemGroup>
1616

0 commit comments

Comments
 (0)