SDK breaking changes (#37982)

Author: gewarren

docs/core/compatibility/8.0.md

@@ -2,7 +2,7 @@
 title: Breaking changes in .NET 8
 titleSuffix: ""
 description: Navigate to the breaking changes in .NET 8.
-ms.date: 10/05/2023
+ms.date: 11/08/2023
 no-loc: [Blazor, Razor, Kestrel]
 ---
 # Breaking changes in .NET 8
@@ -135,7 +135,9 @@ If you're migrating an app to .NET 8, the breaking changes listed here might aff
 | [--arch option doesn't imply self-contained](sdk/8.0/arch-option.md)                               | Behavioral change                                |
 | ['dotnet restore' produces security vulnerability warnings](sdk/8.0/dotnet-restore-audit.md)       | Behavioral change                                |
 | [SDK uses a smaller RID graph](sdk/8.0/rid-graph.md)                                               | Behavioral change/Source incompatible            |
+| [Source Link included in the .NET SDK](sdk/8.0/source-link.md)                                     | Source incompatible                              |
 | [Trimming may not be used with .NET Standard or .NET Framework](sdk/8.0/trimming-unsupported-targetframework.md) | Behavioral change                                |
+| [Unlisted packages not installed by default for .NET tools](sdk/8.0/unlisted-versions.md)                         | Behavioral change                                |
 | [Version requirements for .NET 8 SDK](sdk/8.0/version-requirements.md) | Source incompatible               |
 
 ## Serialization

docs/core/compatibility/sdk/8.0/source-link.md

@@ -0,0 +1,32 @@
+---
+title: "Breaking change: Source Link included in the .NET SDK"
+description: Learn about a breaking change in the .NET 8 SDK where Source Link is included, and commit information is included in InformationalVersion.
+ms.date: 11/08/2023
+---
+# Source Link included in the .NET SDK
+
+The [Source Link](https://github.com/dotnet/sourcelink) build tooling is now included in the .NET SDK. Source Link enables packages and applications to embed information about the source control information of the built artifacts. As a side effect, commit information is included in the `InformationalVersion` value of built libraries and applications.
+
+## Previous behavior
+
+Prior to this change, the default `InformationalVersion` of a library or application was the `Version` property.
+
+## New behavior
+
+Starting in .NET 8, the default `InformationalVersion` of a library or application is the `Version` property *and* the `SourceRevisionId` property.
+
+## Version introduced
+
+.NET 8 Preview 4
+
+## Type of breaking change
+
+This change can affect [source compatibility](../../categories.md#source-compatibility).
+
+## Reason for change
+
+Source Link enables rich editor tooling, like go-to-definition support for non-local source files. This benefit is worth including by default for all artifacts.
+
+## Recommended action
+
+If your build process or code doesn't expect Source Revision information in `InformationalVersion`, you can disable the new behavior by setting the `IncludeSourceRevisionInInformationalVersion` property to `false` in your project file.

docs/core/compatibility/sdk/8.0/unlisted-versions.md

@@ -0,0 +1,32 @@
+---
+title: "Breaking change: Unlisted packages not installed by default for .NET tools"
+description: Learn about a breaking change in the .NET 8 SDK where `dotnet tool install` no longer installs tools from unlisted versions of NuGet packages.
+ms.date: 11/07/2023
+---
+# Unlisted packages not installed by default for .NET tools
+
+The [dotnet tool install](../../../tools/dotnet-tool-install.md) commands no longer install tools from [unlisted versions](/nuget/nuget-org/policies/deleting-packages#unlisting-a-package) of NuGet packages by default. You can still force the install by specifying the unlisted version as an exact version surrounded with brackets, for example `--version [5.0.0]`.
+
+## Previous behavior
+
+Previously, when you installed a .NET tool, the .NET SDK installed tools (and versions of tools) without considering whether the tool package was unlisted.
+
+## New behavior
+
+Starting in .NET 8, unlisted tool versions aren't installed unless you specify the exact version using the `--version` option and brackets around the version number. For example, `--version [5.0.0]`.
+
+## Version introduced
+
+.NET 8 GA
+
+## Type of breaking change
+
+This change is a [behavioral change](../../categories.md#behavioral-change).
+
+## Reason for change
+
+The correct default behavior is to ignore [unlisted packages](/nuget/nuget-org/policies/deleting-packages#unlisting-a-package) when installing tools. Unlisted versions are purposefully hidden from search on NuGet.org.
+
+## Recommended action
+
+To install an unlisted tool, specify the exact version of the tool surrounded with brackets, for example `--version [5.0.0]`.

docs/core/compatibility/toc.yml

@@ -156,8 +156,12 @@ items:
         href: sdk/8.0/arch-option.md
       - name: SDK uses a smaller RID graph
         href: sdk/8.0/rid-graph.md
-      - name: Trimming may not be used with .NET Standard or .NET Framework
+      - name: Source Link included in the .NET SDK
+        href: sdk/8.0/source-link.md
+      - name: Trimming can't be used with .NET Standard or .NET Framework
         href: sdk/8.0/trimming-unsupported-targetframework.md
+      - name: Unlisted packages not installed by default
+        href: sdk/8.0/unlisted-versions.md
       - name: Version requirements for .NET 8 SDK
         href: sdk/8.0/version-requirements.md
     - name: Serialization
@@ -1532,8 +1536,12 @@ items:
         href: sdk/8.0/arch-option.md
       - name: SDK uses a smaller RID graph
         href: sdk/8.0/rid-graph.md
-      - name: Trimming may not be usedwith .NET Standard or .NET Framework
+      - name: Source Link included in the .NET SDK
+        href: sdk/8.0/source-link.md
+      - name: Trimming can't be used with .NET Standard or .NET Framework
         href: sdk/8.0/trimming-unsupported-targetframework.md
+      - name: Unlisted packages not installed by default
+        href: sdk/8.0/unlisted-versions.md
       - name: Version requirements for .NET 8 SDK
         href: sdk/8.0/version-requirements.md
     - name: .NET 7