Skip to content

Conversation

Copilot
Copy link
Contributor

@Copilot Copilot AI commented Aug 30, 2025

This PR adds comprehensive breaking change documentation for the behavioral change where dotnet new sln defaults to creating SLNX-format solution files instead of SLN-format files in .NET 10 RC 1.

Changes Made

  • Created new breaking change document at docs/core/compatibility/sdk/10.0/dotnet-new-sln-slnx-default.md following the official template structure
  • Updated the compatibility index (docs/core/compatibility/10.0.md) to include the new breaking change in the SDK and MSBuild section table
  • Updated the table of contents (docs/core/compatibility/toc.yml) to include proper navigation for the new document

Documentation Details

The breaking change document includes:

  • Clear description of the behavioral change from SLN to SLNX format
  • Code examples showing both previous SLN format and new SLNX format
  • Proper categorization as a behavioral change with link to categories
  • Justification explaining the benefits of SLNX format and its stability since 9.0.200
  • Recommended action for users who still need SLN format: dotnet new sln --format sln
  • Appropriate frontmatter with AI disclosure and issue reference

Both the index table and TOC entries are placed in alphabetical order to maintain consistency with existing documentation structure.

Fixes #48192.


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.


Internal previews

📄 File 🔗 Preview link
docs/core/compatibility/10.0.md Breaking changes in .NET 10
docs/core/compatibility/sdk/10.0/dotnet-new-sln-slnx-default.md dotnet new sln defaults to SLNX file format
docs/core/compatibility/toc.yml docs/core/compatibility/toc
docs/core/tools/dotnet-sln.md dotnet sln

…NX format

Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
@Copilot Copilot AI changed the title [WIP] [Breaking change]: dotnet new sln defaults to SLNX file format Add breaking change documentation for dotnet new sln defaulting to SLNX format Aug 30, 2025
@Copilot Copilot AI requested a review from gewarren August 30, 2025 00:27
Copilot finished work on behalf of gewarren August 30, 2025 00:27
@gewarren gewarren marked this pull request as ready for review August 30, 2025 02:15
@gewarren gewarren requested review from adegeo and a team as code owners August 30, 2025 02:15
@gewarren gewarren requested a review from baronfel August 30, 2025 02:15
Copy link
Member

@baronfel baronfel left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM - and thank you for also changing the dotnet sln docs to match!

@gewarren gewarren merged commit b191e1e into main Aug 30, 2025
11 checks passed
@gewarren gewarren deleted the copilot/fix-48192 branch August 30, 2025 02:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[Breaking change]: dotnet new sln defaults to SLNX file format
3 participants