Use relative urls + fix broken links - .NET Core 3.1 release notes (#…

…9510)

* Use relative urls + fix broken links - .NET Core 3.1 release notes

* fix broken links

* fix broken links

* fix another broken link

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

@@ -1,8 +1,8 @@
 # .NET Core 3.1 - Supported OS versions
 
-[.NET Core 3.1](README.md) [is supported](https://github.com/dotnet/core/blob/main/microsoft-support.md) on multiple operating systems per their [lifecycle policy](../../os-lifecycle-policy.md).
+[.NET Core 3.1](README.md) [is supported](../../support.md) on multiple operating systems per their [lifecycle policy](../../os-lifecycle-policy.md).
 
-For issues with .NET on operating systems not listed here, please open a GitHub issue in the appropriate .NET repository or contact the OS maintainer community . Please see [.NET Repos](https://github.com/dotnet/core/blob/main/Documentation/core-repos.md) for the repository list.
+For issues with .NET on operating systems not listed here, please open a GitHub issue in the appropriate .NET repository or contact the OS maintainer community . Please see [.NET Repos](../../Documentation/core-repos.md) for the repository list.
 
 ## Keys used in the tables
 
@@ -32,7 +32,7 @@ Mac OS X                      | 10.15+                        | x64            |
 
 ## Linux
 
-Alpine 3.14 and Debian 11 are now supported with the .NET 5.0.10 and .NET Core 3.1.19. The operating system support pages for [.NET 5.0](https://github.com/dotnet/core/blob/main/release-notes/5.0/5.0-supported-os.md) and [.NET Core 3.1](https://github.com/dotnet/core/blob/main/release-notes/3.1/3.1-supported-os.md) have been updated to reflect that.
+Alpine 3.14 and Debian 11 are now supported with the .NET 5.0.10 and .NET Core 3.1.19. The operating system support pages for [.NET 5.0](../5.0/5.0-supported-os.md) and [.NET Core 3.1](3.1-supported-os.md) have been updated to reflect that.
 
 OS                            | Version                       | Architectures  | Notes
 ------------------------------|-------------------------------|----------------|-----
@@ -53,7 +53,7 @@ Note: .NET Core 3.1 requires OpenSSL 1.x. Newer distro versions such as Ubuntu 2
 
 ## Out of support OS versions
 
-Support for the following versions was ended by the distribution owners and are [no longer supported by .NET Core 3.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 3.1](../../os-lifecycle-policy.md).
 
 |OS         | Version  | End of Life | Supported Version|
 |-----------|----------|-------------|------------------|

release-notes/3.1/3.1.0/3.1.0-install-instructions.md

@@ -6,7 +6,7 @@
 * ASP.NET Core 3.1.0
 * .NET Core 3.1.100
 
-See the [Release Notes](3.1.0) for details about what is included in this update.
+See the [Release Notes](3.1.0.md) for details about what is included in this update.
 
 ## Docker
 
@@ -26,7 +26,7 @@ When .NET Core in installed using the Snap package, the default .NET Core comman
 
 `sudo snap alias dotnet-sdk.dotnet dotnet`
 
-**Note:** Some distributions 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 distributions 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.
 
 ## Windows Server Hosting
 
@@ -42,13 +42,12 @@ 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/3.1/3.1.0.md
+[release-notes]: 3.1.0.md
 
 [checksums-runtime]: https://dotnetcli.blob.core.windows.net/dotnet/checksums/3.1.0-sha.txt
 [checksums-sdk]: https://dotnetcli.blob.core.windows.net/dotnet/checksums/3.1.0-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/announcing-net-core-3-1-0/
 [aspnet-blog]: https://devblogs.microsoft.com/aspnet/asp-net-core-updates-in-net-core-3-1-preview-3/

release-notes/3.1/3.1.0/3.1.0.md

@@ -55,14 +55,13 @@ Here is list of some of the additions and updates we're excited to bring in 3.1.
 
 [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/3.1/3.1.0/3.1.0.md
+[release-notes]: 3.1.0.md
 [snap-install]: 3.1.0-install-instructions.md
 
 [checksums-runtime]: https://dotnetcli.blob.core.windows.net/dotnet/checksums/3.1.0-sha.txt
 [checksums-sdk]: https://dotnetcli.blob.core.windows.net/dotnet/checksums/3.1.0-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/announcing-net-core-3-1/
 [aspnet-blog]: https://devblogs.microsoft.com/aspnet/asp-net-core-updates-in-net-core-3-1/

release-notes/3.1/3.1.1/3.1.1-install-instructions.md

@@ -6,7 +6,7 @@
 * ASP.NET Core 3.1.1
 * .NET Core SDK 3.1.101
 
-See the [Release Notes](https://github.com/dotnet/core/blob/main/release-notes/3.1/3.1.1/3.1.1.md) for details about what is included in this update.
+See the [Release Notes](3.1.1.md) for details about what is included in this update.
 
 ## Docker
 
@@ -26,7 +26,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
 
@@ -59,7 +59,7 @@ sudo [package manager] install aspnetcore-runtime-3.1
 
 ### Installation from a binary archive
 
-Installing from the packages detailed above is recommended or you can install from binary archive, if that better suits your needs. When using binary archives to install, the contents must be extracted to a user location such as `$HOME/dotnet`, a symbolic link created for `dotnet` and a few dependencies installed. Dependency requirements can be seen in the [Linux System Prerequisites](https://github.com/dotnet/core/blob/main/Documentation/linux-prereqs.md) document.
+Installing from the packages detailed above is recommended or you can install from binary archive, if that better suits your needs. When using binary archives to install, the contents must be extracted to a user location such as `$HOME/dotnet`, a symbolic link created for `dotnet` and a few dependencies installed. Dependency requirements can be seen in the [Linux System Prerequisites](../linux-packages.md) document.
 
 ```bash
 mkdir -p $HOME/dotnet && tar zxf dotnet.tar.gz -C $HOME/dotnet
@@ -84,13 +84,12 @@ 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/3.1/3.1.1/3.1.1.md
+[release-notes]: 3.1.1.md
 
 [checksums-runtime]: https://dotnetcli.blob.core.windows.net/dotnet/checksums/3.1.1-sha.txt
 [checksums-sdk]: https://dotnetcli.blob.core.windows.net/dotnet/checksums/3.1.1-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/3.1/3.1.1/3.1.1.md

@@ -51,13 +51,13 @@ The following repos have been updated
 
 [.NET Core 2.2 reached end of life](https://github.com/dotnet/announcements/issues/147/) on December 23, 2019. This means .NET Core 2.2 is no longer supported and updates will no longer be provided. We recommend moving to .NET Core 3.1, our long term support (LTS) release.
 
-.NET Core 3.0 will reach end of life on March 3, 2020 which is 3 months after the release of .NET Core 3.1. You can view the [Microsoft Support for .NET Core](https://github.com/dotnet/core/blob/main/microsoft-support.md) for more information about life-cycle of each product.
+.NET Core 3.0 will reach end of life on March 3, 2020 which is 3 months after the release of .NET Core 3.1. You can view the [Microsoft Support for .NET Core](../../../support.md) for more information about life-cycle of each product.
 
 Fedora 29 has been out of support since [November 29, 2019](https://fedoraproject.org/wiki/End_of_life) and .NET Core no longer provides support for it.
 
 Ubuntu 19.04 will be out of support on [January 23, 2020](https://lists.ubuntu.com/archives/ubuntu-announce/2020-January/thread.html).
 
-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 3.1.1
 
@@ -142,14 +142,13 @@ Microsoft.WindowsDesktop.App  | 3.1.0 | 3.1.1
 
 [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/3.1/3.1.1/3.1.1.md
+[release-notes]: 3.1.1.md
 [snap-install]: 3.1.1-install-instructions.md
 
 [checksums-runtime]: https://dotnetcli.blob.core.windows.net/dotnet/checksums/3.1.1-sha.txt
 [checksums-sdk]: https://dotnetcli.blob.core.windows.net/dotnet/checksums/3.1.1-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-january-2020/
 [aspnet-blog]: https://devblogs.microsoft.com/aspnet/asp-net-core-updates-in-net-core-3-1/

release-notes/3.1/3.1.10/3.1.10-install-instructions.md

@@ -6,7 +6,7 @@
 * ASP.NET Core 3.1.10
 * .NET Core SDK 3.1.110
 
-See the [Release Notes](https://github.com/dotnet/core/blob/main/release-notes/3.1/3.1.10/3.1.10.md) for details about what is included in this update.
+See the [Release Notes](3.1.10.md) for details about what is included in this update.
 
 ## Docker
 
@@ -26,7 +26,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
 
@@ -59,7 +59,7 @@ sudo [package manager] install aspnetcore-runtime-3.1
 
 ### Installation from a binary archive
 
-Installing from the packages detailed above is recommended or you can install from binary archive, if that better suits your needs. When using binary archives to install, the contents must be extracted to a user location such as `$HOME/dotnet`, a symbolic link created for `dotnet` and a few dependencies installed. Dependency requirements can be seen in the [Linux System Prerequisites](https://github.com/dotnet/core/blob/main/Documentation/linux-prereqs.md) document.
+Installing from the packages detailed above is recommended or you can install from binary archive, if that better suits your needs. When using binary archives to install, the contents must be extracted to a user location such as `$HOME/dotnet`, a symbolic link created for `dotnet` and a few dependencies installed. Dependency requirements can be seen in the [Linux System Prerequisites](../linux-packages.md) document.
 
 ```bash
 mkdir -p $HOME/dotnet && tar zxf dotnet.tar.gz -C $HOME/dotnet
@@ -84,7 +84,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/3.1/3.1.10/3.1.10.md
+[release-notes]: 3.1.10.md
 
 [checksums-runtime]: https://dotnetcli.blob.core.windows.net/dotnet/checksums/3.1.10-sha.txt
 [checksums-sdk]: https://dotnetcli.blob.core.windows.net/dotnet/checksums/3.1.10-sha.txt

release-notes/3.1/3.1.10/3.1.10.md

@@ -343,7 +343,7 @@ Microsoft.Extensions.Logging.Abstractions | 3.1.10.nupkg
 
 [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/3.1/3.1.10/3.1.10.md
+[release-notes]: 3.1.10.md
 [snap-install]: 3.1.10-install-instructions.md
 
 [checksums-runtime]: https://dotnetcli.blob.core.windows.net/dotnet/checksums/3.1.10-sha.txt

release-notes/3.1/3.1.10/3.1.404-download.md

@@ -6,7 +6,7 @@ This .NET Core SDK release includes the following released .NET Core and ASP.NET
 * .NET Core Runtime 3.1.10
 * ASP.NET Core 3.1.10
 
-See the [Release Notes](https://github.com/dotnet/core/blob/main/release-notes/3.1/3.1.10/3.1.10.md) for details about what is included in this update.
+See the [Release Notes](3.1.10.md) for details about what is included in this update.
 
 
 ## Downloads
@@ -51,7 +51,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
 
@@ -87,7 +87,7 @@ sudo [package manager] install aspnetcore-runtime-3.1
 
 ### Installation from a binary archive
 
-Installing from the packages detailed above is recommended or you can install from binary archive, if that better suits your needs. When using binary archives to install, the contents must be extracted to a user location such as `$HOME/dotnet`, a symbolic link created for `dotnet` and a few dependencies installed. Dependency requirements can be seen in the [Linux System Prerequisites](https://github.com/dotnet/core/blob/main/Documentation/linux-prereqs.md) document.
+Installing from the packages detailed above is recommended or you can install from binary archive, if that better suits your needs. When using binary archives to install, the contents must be extracted to a user location such as `$HOME/dotnet`, a symbolic link created for `dotnet` and a few dependencies installed. Dependency requirements can be seen in the [Linux System Prerequisites](../linux-packages.md) document.
 
 ```bash
 mkdir -p $HOME/dotnet && tar zxf dotnet.tar.gz -C $HOME/dotnet
@@ -112,7 +112,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/3.1/3.1.10/3.1.404-download.md
+[release-notes]: 3.1.404-download.md
 [snap-install]: 3.1.10-install-instructions.md
 
 [checksums-runtime]: https://dotnetcli.blob.core.windows.net/dotnet/checksums/3.1.10-sha.txt

release-notes/3.1/3.1.11/3.1.11-install-instructions.md

@@ -6,7 +6,7 @@
 * ASP.NET Core 3.1.11
 * .NET Core SDK 3.1.111
 
-See the [Release Notes](https://github.com/dotnet/core/blob/main/release-notes/3.1/3.1.11/3.1.11.md) for details about what is included in this update.
+See the [Release Notes](3.1.11.md) for details about what is included in this update.
 
 ## Docker
 
@@ -26,7 +26,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
 
@@ -59,7 +59,7 @@ sudo [package manager] install aspnetcore-runtime-3.1
 
 ### Installation from a binary archive
 
-Installing from the packages detailed above is recommended or you can install from binary archive, if that better suits your needs. When using binary archives to install, the contents must be extracted to a user location such as `$HOME/dotnet`, a symbolic link created for `dotnet` and a few dependencies installed. Dependency requirements can be seen in the [Linux System Prerequisites](https://github.com/dotnet/core/blob/main/Documentation/linux-prereqs.md) document.
+Installing from the packages detailed above is recommended or you can install from binary archive, if that better suits your needs. When using binary archives to install, the contents must be extracted to a user location such as `$HOME/dotnet`, a symbolic link created for `dotnet` and a few dependencies installed. Dependency requirements can be seen in the [Linux System Prerequisites](../linux-packages.md) document.
 
 ```bash
 mkdir -p $HOME/dotnet && tar zxf dotnet.tar.gz -C $HOME/dotnet
@@ -84,7 +84,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/3.1/3.1.11/3.1.11.md
+[release-notes]: 3.1.11.md
 
 [checksums-runtime]: https://dotnetcli.blob.core.windows.net/dotnet/checksums/3.1.11-sha.txt
 [checksums-sdk]: https://dotnetcli.blob.core.windows.net/dotnet/checksums/3.1.11-sha.txt

release-notes/3.1/3.1.11/3.1.11.md

@@ -340,7 +340,7 @@ Microsoft.Extensions.Localization.Abstractions | 3.1.11.nupkg
 
 [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/3.1/3.1.11/3.1.11.md
+[release-notes]: 3.1.11.md
 [snap-install]: 3.1.11-install-instructions.md
 
 [checksums-runtime]: https://dotnetcli.blob.core.windows.net/dotnet/checksums/3.1.11-sha.txt