Merge branch 'main' into marcpopMSFT-workloadrestore

README.md

@@ -8,11 +8,11 @@ Welcome to the home of .NET [release notes](./release-notes/README.md) and [news
 
 |  Version  | Release Date | Support | Latest Patch Version | End of Support |
 | :-- | :-- | :-- | :-- | :-- |
-| [.NET 9](release-notes/9.0/README.md) | November 12, 2024 | [STS][policies] | [9.0.0-preview.7][9.0.0-preview.7] | May 12, 2026 |
+| [.NET 9](release-notes/9.0/README.md) | November 12, 2024 | [STS][policies] | [9.0.0-rc.1][9.0.0-rc.1] | May 12, 2026 |
 | [.NET 8](release-notes/8.0/README.md) | [November 14, 2023](https://devblogs.microsoft.com/dotnet/announcing-dotnet-8/) | [LTS][policies] | [8.0.8][8.0.8] | November 10, 2026 |
 | [.NET 6](release-notes/6.0/README.md) | [November 8, 2021](https://devblogs.microsoft.com/dotnet/announcing-net-6/) | [LTS][policies] | [6.0.33][6.0.33]  | November 12, 2024 |
 
-[9.0.0-preview.7]: release-notes/9.0/preview/preview7/9.0.0-preview.7.md
+[9.0.0-rc.1]: release-notes/9.0/preview/rc1/9.0.0-rc.1.md
 [8.0.8]: release-notes/8.0/8.0.8/8.0.8.md
 [6.0.33]: release-notes/6.0/6.0.33/6.0.33.md
 [policies]: release-policies.md

release-notes/2.1/2.1-supported-os.md

@@ -46,7 +46,7 @@ Alpine Linux                  | 3.10, 3.11, 3.12                          | x64
 
 ## Out of support OS versions
 
-Support for the following versions was ended by the distribution owners and are [no longer supported by .NET Core 2.1](https://github.com/dotnet/core/blob/main/os-lifecycle-policy.md).
+Support for the following versions was ended by the distribution owners and are [no longer supported by .NET Core 2.1](../../os-lifecycle-policy.md).
 
 |OS         | Version  | End of Life |
 |-----------|----------|-------------|

release-notes/2.1/2.1.0.md

@@ -1,6 +1,6 @@
 # .NET Core 2.1 - May 30, 2018
 
-.NET Core 2.1.0 is available for download and usage in your environment. Have a look at the [Known Issues](2.1.0-known-issues.md) document as there are a few things to be aware of before installing. A [changelist](https://github.com/dotnet/core/blob/main/release-notes/2.1/2.1.0-commit.md) for the entire 2.1 development cycle is also available. This does not include ASP.NET Core or Entity Framework Core.
+.NET Core 2.1.0 is available for download and usage in your environment. Have a look at the [Known Issues](2.1.0-known-issues.md) document as there are a few things to be aware of before installing. A [changelist](2.1.0-commit.md) for the entire 2.1 development cycle is also available. This does not include ASP.NET Core or Entity Framework Core.
 
 * [Download .NET Core](https://dotnet.microsoft.com/download)
 
@@ -93,4 +93,4 @@ On Linux and macOS, you can only configure `HttpClient` on a process-basis. On L
 
 ### API changes
 
-See all changes from 2.0 in the [detailed API diff](https://github.com/dotnet/core/blob/main/release-notes/2.1/api-diff/2.0-vs-2.1.md) to help determine if any will impact existing projects built on .NET Core 2.0.
+See all changes from 2.0 in the [detailed API diff](./api-diff/2.0-vs-2.1.md) to help determine if any will impact existing projects built on .NET Core 2.0.

release-notes/2.1/2.1.1.md

@@ -1,8 +1,8 @@
 # .NET Core June 2018 Update - June 21, 2018
 
-.NET Core 2.1.1 is available for download and usage in your environment. Have a look at the [Known Issues](2.1.1-known-issues.md) document as there are a few things to be aware of before installing. A [changelist](https://github.com/dotnet/core/blob/main/release-notes/2.1/2.1.1-commit.md) for the entire 2.1 development cycle is also available. This does not include ASP.NET Core or Entity Framework Core.
+.NET Core 2.1.1 is available for download and usage in your environment. Have a look at the [Known Issues](2.1.1-known-issues.md) document as there are a few things to be aware of before installing. A [changelist](2.1.1-commit.md) for the entire 2.1 development cycle is also available. This does not include ASP.NET Core or Entity Framework Core.
 
-* [Download .NET Core](https://github.com/dotnet/core/blob/main/release-notes/download-archives/2.1.1-download.md)
+* [Download .NET Core](../download-archives/2.1.1-download.md)
 
 ## Blog Round up
 
@@ -29,14 +29,14 @@ It was announced in the [2.1 blog post](https://devblogs.microsoft.com/dotnet/an
 [.NET Core 2.0](https://devblogs.microsoft.com/dotnet/announcing-net-core-2-0/) was released on August 14, 2017. As a non-LTS release, it is supported for 3 months after the next release.
 [.NET Core 2.1](https://devblogs.microsoft.com/dotnet/announcing-net-core-2-1/) was released on May 30th, 2018. As a result, .NET Core 2.0 will be supported until September 1, 2018.
 
-Microsoft has a published [support policy](https://github.com/dotnet/core/blob/main/microsoft-support.md) for .NET Core. It includes policies for two release types: LTS and Current. .NET Core 2.0 is a Current release.
+Microsoft has a published [support policy](../../support.md) for .NET Core. It includes policies for two release types: LTS and Current. .NET Core 2.0 is a Current release.
 
 * LTS releases include features and components that have been stabilized, requiring few updates over a longer support release lifetime. These releases are a good choice for hosting applications that you do not intend to update often.
 * Current releases include features and components that are new and that may undergo future change based on feedback. These releases are a good choice for applications in active development, giving you access to the latest features and improvements. You need to upgrade to later .NET Core releases more often to stay in support.
 
 Both types of releases receive critical fixes throughout their lifecycle, for security, reliability, or to add support for new operating system versions. You must stay up-to-date with the latest patches to qualify for support.
 
-See [.NET Core Supported OS Lifecycle Policy](https://github.com/dotnet/core/blob/main/os-lifecycle-policy.md) to learn about Windows, macOS and Linux versions that are supported for each .NET Core release.
+See [.NET Core Supported OS Lifecycle Policy](../../os-lifecycle-policy.md) to learn about Windows, macOS and Linux versions that are supported for each .NET Core release.
 
 After that time, .NET Core patch updates will no longer include updated packages for .NET Core 2.0.
 

release-notes/2.1/2.1.10/2.1.10-download.md

@@ -6,7 +6,7 @@
 * ASP.NET Core 2.1.10
 * .NET Core SDK
 
-See the [Release Notes](https://github.com/dotnet/core/blob/main/release-notes/2.1/2.1.10/2.1.10.md) for details about what is included in this update.
+See the [Release Notes](2.1.10.md) for details about what is included in this update.
 
 **Note:** If you are a Visual Studio user, there are MSBuild version requirements so use only the .NET Core SDK supported for each Visual Studio version. If you use other development environments, we recommend using the latest SDK release.
 
@@ -49,7 +49,7 @@ When .NET Core in installed using the Snap package, the default .NET Core comman
 
 `sudo snap alias dotnet-sdk.dotnet dotnet`
 
-**Note:** Some distros require an additional step to enable access to the SSL certificate. If you experience SSL errors when running `dotnet restore`, see [Linux Setup](https://github.com/dotnet/core/blob/main/Documentation/linux-setup.md) for a possible resolution.
+**Note:** Some distros require an additional step to enable access to the SSL certificate. If you experience SSL errors when running `dotnet restore`, see [.NET for Linux Distributions](../../../linux.md) for a possible resolution.
 
 ### Install using a Package Manager
 
@@ -107,7 +107,7 @@ This will install the ASP.NET Core Module for IIS.
 
 [blob-runtime]: https://dotnetcli.blob.core.windows.net/dotnet/Runtime/
 [blob-sdk]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/
-[release-notes]: https://github.com/dotnet/core/blob/main/release-notes/2.1/2.1.10/2.1.10.md
+[release-notes]: 2.1.10.md
 
 [dotnet-runtime-linux-arm.tar.gz]: https://download.visualstudio.microsoft.com/download/pr/b3a0363f-4ea6-43c1-b5bf-f15e1b88b428/eda34aff06bd3bfd53cf156427ccd3a3/dotnet-runtime-2.1.10-linux-arm.tar.gz
 [dotnet-runtime-linux-arm64.tar.gz]: https://download.visualstudio.microsoft.com/download/pr/23bde323-de7b-4176-b120-6b5d242b49dd/a7a88339ce8c9708b7654f373f484910/dotnet-runtime-2.1.10-linux-arm64.tar.gz
@@ -156,6 +156,5 @@ This will install the ASP.NET Core Module for IIS.
 [checksums-sdk]: https://dotnetcli.blob.core.windows.net/dotnet/checksums/2.1.506-sdk-sha.txt
 
 [linux-install]: https://learn.microsoft.com/dotnet/core/install/linux
-[linux-setup]: https://github.com/dotnet/core/blob/main/Documentation/linux-setup.md
 
 [dotnet-blog]: https://devblogs.microsoft.com/dotnet/

release-notes/2.1/2.1.10/2.1.10.md

@@ -41,8 +41,8 @@ The [.NET Core Docker images](https://hub.docker.com/r/microsoft/dotnet/) have b
 
 The following repos have been updated
 
-* [microsoft/dotnet](https://hub.docker.com/r/microsoft/dotnet)
-* [microsoft/dotnet-samples](https://hub.docker.com/r/microsoft/dotnet-samples)
+* [microsoft/dotnet](https://github.com/dotnet/dotnet-docker/blob/main/README.md)
+* [microsoft/dotnet-samples](https://github.com/dotnet/dotnet-docker/blob/main/README.samples.md)
 
 ### Azure AppServices
 
@@ -54,7 +54,7 @@ There are no changes this month in OS version support status.
 
 .NET Core 1.0 and 1.1, which entered "Maintenance" support status when 2.1 was declared LTS, will be end-of-life June 27, 2019. Updates for the 1.0 and 1.1 channels will no longer be offered after that date. See [.NET Core Support Policy](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) to learn more about the .NET Core support lifecycle.
 
-See [.NET Core Supported OS Lifecycle Policy](https://github.com/dotnet/core/blob/main/os-lifecycle-policy.md) to learn about Windows, macOS and Linux versions that are supported for each .NET Core release.
+See [.NET Core Supported OS Lifecycle Policy](../../../os-lifecycle-policy.md) to learn about Windows, macOS and Linux versions that are supported for each .NET Core release.
 
 ## Changes in 2.1.10
 
@@ -144,7 +144,7 @@ runtime.win-x86.microsoft.netcore.dotnethostresolver | 2.1.10
 
 [blob-runtime]: https://dotnetcli.blob.core.windows.net/dotnet/Runtime/
 [blob-sdk]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/
-[release-notes]: https://github.com/dotnet/core/blob/main/release-notes/2.1/2.1.10/2.1.10.md
+[release-notes]: 2.1.10.md
 
 [dotnet-runtime-linux-arm.tar.gz]: https://download.visualstudio.microsoft.com/download/pr/b3a0363f-4ea6-43c1-b5bf-f15e1b88b428/eda34aff06bd3bfd53cf156427ccd3a3/dotnet-runtime-2.1.10-linux-arm.tar.gz
 [dotnet-runtime-linux-arm64.tar.gz]: https://download.visualstudio.microsoft.com/download/pr/23bde323-de7b-4176-b120-6b5d242b49dd/a7a88339ce8c9708b7654f373f484910/dotnet-runtime-2.1.10-linux-arm64.tar.gz

release-notes/2.1/2.1.11/2.1.11-download.md

@@ -49,7 +49,7 @@ When .NET Core in installed using the Snap package, the default .NET Core comman
 
 `sudo snap alias dotnet-sdk.dotnet dotnet`
 
-**Note:** Some distros require an additional step to enable access to the SSL certificate. If you experience SSL errors when running `dotnet restore`, see [Linux Setup](https://github.com/dotnet/core/blob/main/Documentation/linux-setup.md) for a possible resolution.
+**Note:** Some distros require an additional step to enable access to the SSL certificate. If you experience SSL errors when running `dotnet restore`, see [.NET for Linux Distributions](../../../linux.md) for a possible resolution.
 
 ### Install using a Package Manager
 
@@ -107,7 +107,7 @@ This will install the ASP.NET Core Module for IIS.
 
 [blob-runtime]: https://dotnetcli.blob.core.windows.net/dotnet/Runtime/
 [blob-sdk]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/
-[release-notes]: https://github.com/dotnet/core/blob/main/release-notes/2.1/2.1.11/2.1.11.md
+[release-notes]: 2.1.11.md
 
 [dotnet-runtime-linux-arm.tar.gz]: https://download.visualstudio.microsoft.com/download/pr/7e34e5f5-e817-4ba4-9bfe-03f341e2a807/5779a613184dd09596f71681064cdaa8/dotnet-runtime-2.1.11-linux-arm.tar.gz
 [dotnet-runtime-linux-arm64.tar.gz]: https://download.visualstudio.microsoft.com/download/pr/f3238746-7a47-407f-9d30-20de4bfd93e2/0c26aad99851325fd5240909f120614d/dotnet-runtime-2.1.11-linux-arm64.tar.gz
@@ -153,6 +153,5 @@ This will install the ASP.NET Core Module for IIS.
 [checksums-sdk]: https://dotnetcli.blob.core.windows.net/dotnet/checksums/2.1.507-sdk-sha.txt
 
 [linux-install]: https://learn.microsoft.com/dotnet/core/install/linux
-[linux-setup]: https://github.com/dotnet/core/blob/main/Documentation/linux-setup.md
 [dotnet-blog]: https://devblogs.microsoft.com/dotnet/net-core-may-2019/
 

release-notes/2.1/2.1.11/2.1.11.md

@@ -41,8 +41,8 @@ The [.NET Core Docker images](https://hub.docker.com/r/microsoft/dotnet/) have b
 
 The following repos have been updated
 
-* [microsoft/dotnet](https://hub.docker.com/r/microsoft/dotnet)
-* [microsoft/dotnet-samples](https://hub.docker.com/r/microsoft/dotnet-samples)
+* [microsoft/dotnet](https://github.com/dotnet/dotnet-docker/blob/main/README.md)
+* [microsoft/dotnet-samples](https://github.com/dotnet/dotnet-docker/blob/main/README.samples.md)
 
 ### Azure AppServices
 
@@ -54,7 +54,7 @@ Ubuntu 14.04 reached the [end of standard support April 2019](https://wiki.ubunt
 
 .NET Core 1.0 and 1.1, which entered "Maintenance" support status when 2.1 was declared LTS, will be end-of-life June 27, 2019. Updates for the 1.0 and 1.1 channels will no longer be offered after that date. See [.NET Core Support Policy](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) to learn more about the .NET Core support lifecycle.
 
-See [.NET Core Supported OS Lifecycle Policy](https://github.com/dotnet/core/blob/main/os-lifecycle-policy.md) to learn about Windows, macOS and Linux versions that are supported for each .NET Core release.
+See [.NET Core Supported OS Lifecycle Policy](../../../os-lifecycle-policy.md) to learn about Windows, macOS and Linux versions that are supported for each .NET Core release.
 
 ## Changes in 2.1.11
 
@@ -215,7 +215,7 @@ System.Memory|4.5.3
 
 [blob-runtime]: https://dotnetcli.blob.core.windows.net/dotnet/Runtime/
 [blob-sdk]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/
-[release-notes]: https://github.com/dotnet/core/blob/main/release-notes/2.1/2.1.11/2.1.11.md
+[release-notes]: 2.1.11.md
 
 [dotnet-runtime-linux-arm.tar.gz]: https://download.visualstudio.microsoft.com/download/pr/7e34e5f5-e817-4ba4-9bfe-03f341e2a807/5779a613184dd09596f71681064cdaa8/dotnet-runtime-2.1.11-linux-arm.tar.gz
 [dotnet-runtime-linux-arm64.tar.gz]: https://download.visualstudio.microsoft.com/download/pr/f3238746-7a47-407f-9d30-20de4bfd93e2/0c26aad99851325fd5240909f120614d/dotnet-runtime-2.1.11-linux-arm64.tar.gz

release-notes/2.1/2.1.12/2.1.12-download.md

@@ -6,7 +6,7 @@
 * ASP.NET Core 2.1.12
 * .NET Core SDK 2.1.508
 
-See the [Release Notes](https://github.com/dotnet/core/blob/main/release-notes/2.1/2.1.12/2.1.12.md) for details about what is included in this update.
+See the [Release Notes](2.1.12.md) for details about what is included in this update.
 
 **NOTE:** If you are a Visual Studio user, there are MSBuild version requirements so use only the .NET Core SDK supported for each Visual Studio version. If you use other development environments, we recommend using the latest SDK release.
 
@@ -50,7 +50,7 @@ When .NET Core in installed using the Snap package, the default .NET Core comman
 
 `sudo snap alias dotnet-sdk.dotnet dotnet`
 
-**Note:** Some distros require an additional step to enable access to the SSL certificate. If you experience SSL errors when running `dotnet restore`, see [Linux Setup](https://github.com/dotnet/core/blob/main/Documentation/linux-setup.md) for a possible resolution.
+**Note:** Some distros require an additional step to enable access to the SSL certificate. If you experience SSL errors when running `dotnet restore`, see [.NET for Linux Distributions](../../../linux.md) for a possible resolution.
 
 ### Install using a Package Manager
 
@@ -108,7 +108,7 @@ This will install the ASP.NET Core Module for IIS.
 
 [blob-runtime]: https://dotnetcli.blob.core.windows.net/dotnet/Runtime/
 [blob-sdk]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/
-[release-notes]: https://github.com/dotnet/core/blob/main/release-notes/2.1/2.1.12/2.1.12.md
+[release-notes]: 2.1.12.md
 
 [//]: # ( Runtime 2.1.12)
 [dotnet-runtime-linux-arm.tar.gz]: https://download.visualstudio.microsoft.com/download/pr/f759670e-1f8d-4f1a-8eb7-58b95f94c68c/69eca04ca138dc6c3caa160bd1b891d1/dotnet-runtime-2.1.12-linux-arm.tar.gz
@@ -162,6 +162,5 @@ This will install the ASP.NET Core Module for IIS.
 [checksums-sdk]: https://dotnetcli.blob.core.windows.net/dotnet/checksums/2.1.701-sdk-sha.txt
 
 [linux-install]: https://learn.microsoft.com/dotnet/core/install/linux
-[linux-setup]: https://github.com/dotnet/core/blob/main/Documentation/linux-setup.md
 
 [dotnet-blog]: https://devblogs.microsoft.com/dotnet/

release-notes/2.1/2.1.12/2.1.12.md

@@ -44,8 +44,8 @@ The [.NET Core Docker images](https://hub.docker.com/r/microsoft/dotnet/) have b
 
 The following repos have been updated
 
-* [microsoft/dotnet](https://hub.docker.com/r/microsoft/dotnet)
-* [microsoft/dotnet-samples](https://hub.docker.com/r/microsoft/dotnet-samples)
+* [microsoft/dotnet](https://github.com/dotnet/dotnet-docker/blob/main/README.md)
+* [microsoft/dotnet-samples](https://github.com/dotnet/dotnet-docker/blob/main/README.samples.md)
 
 The images are expected to be available later today.
 
@@ -59,7 +59,7 @@ The images are expected to be available later today.
 
 Debian 10 GA finally released and we expect .NET Core availability on it later this month.
 
-See [.NET Core Supported OS Lifecycle Policy](https://github.com/dotnet/core/blob/main/os-lifecycle-policy.md) to learn about Windows, macOS and Linux versions that are supported for each .NET Core release.
+See [.NET Core Supported OS Lifecycle Policy](../../../os-lifecycle-policy.md) to learn about Windows, macOS and Linux versions that are supported for each .NET Core release.
 
 ## Changes in 2.1.12
 
@@ -158,7 +158,7 @@ runtime.win-x86.Microsoft.NETCore.DotNetHostResolver|2.1.12
 
 [blob-runtime]: https://dotnetcli.blob.core.windows.net/dotnet/Runtime/
 [blob-sdk]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/
-[release-notes]: https://github.com/dotnet/core/blob/main/release-notes/2.1/2.1.12/2.1.12.md
+[release-notes]: 2.1.12.md
 
 [//]: # ( Runtime 2.1.12)
 [dotnet-runtime-linux-arm.tar.gz]: https://download.visualstudio.microsoft.com/download/pr/f759670e-1f8d-4f1a-8eb7-58b95f94c68c/69eca04ca138dc6c3caa160bd1b891d1/dotnet-runtime-2.1.12-linux-arm.tar.gz