Learn rebrand (#8024)

Documentation/diagnostics/portable_pdb.md

@@ -25,7 +25,7 @@ Portable PDBs can be read on any operating system, but there are a number of pla
 * Some symbol servers (ex: SymbolSource.org [does not](https://github.com/SymbolSource/SymbolSource/issues/7#issuecomment-399747015), nuget.org [does](https://blog.nuget.org/20181116/Improved-debugging-experience-with-the-NuGet-org-symbol-server-and-snupkg.html))
 * Running post-compilation build step that consumes or modifies the PDB using older versions of tools such as CCI, CodeContracts.
 * Using .NET decompilers such as ILDASM or .NET Reflector and expecting to see source line mappings or local parameter names.
-* [MS DIA](https://docs.microsoft.com/previous-versions/visualstudio/visual-studio-2015/debugger/debug-interface-access/debug-interface-access-sdk-reference)-based tools such as WinDBG.
+* [MS DIA](https://learn.microsoft.com/previous-versions/visualstudio/visual-studio-2015/debugger/debug-interface-access/debug-interface-access-sdk-reference)-based tools such as WinDBG.
 
 Over time we plan to shrink this list of non-supported scenarios so that portable PDB can become the default choice for most usage needs.
 

Documentation/official-docs.md

@@ -4,10 +4,10 @@ Microsoft maintains official documentation for .NET, listed below. Both .NET and
 
 ## .NET
 
-- [Conceptual docs](https://docs.microsoft.com/dotnet/core/)
-- [API docs](https://docs.microsoft.com/dotnet/api/)
+- [Conceptual docs](https://learn.microsoft.com/dotnet/core/)
+- [API docs](https://learn.microsoft.com/dotnet/api/)
 
 ## .NET Framework
 
-- [Conceptual docs](https://docs.microsoft.com/dotnet/framework/)
-- [API docs](https://docs.microsoft.com/dotnet/api/)
+- [Conceptual docs](https://learn.microsoft.com/dotnet/framework/)
+- [API docs](https://learn.microsoft.com/dotnet/api/)

Documentation/prereqs.md

@@ -1,7 +1,7 @@
 .NET native prerequisites
 ==============================
 
-* [Windows Prerequisites](https://docs.microsoft.com/dotnet/core/install/windows)
-* [macOS Prerequisites](https://docs.microsoft.com/dotnet/core/install/macos)
-* [Linux Prerequisites](https://docs.microsoft.com/dotnet/core/install/linux)
+* [Windows Prerequisites](https://learn.microsoft.com/dotnet/core/install/windows)
+* [macOS Prerequisites](https://learn.microsoft.com/dotnet/core/install/macos)
+* [Linux Prerequisites](https://learn.microsoft.com/dotnet/core/install/linux)
 * [.NET Supported OS Lifecycle Policy](https://github.com/dotnet/core/blob/main/os-lifecycle-policy.md)

README.md

@@ -18,8 +18,8 @@ You can find release notes for all releases, including out-of-support releases,
 
 * [Download .NET](https://dotnet.microsoft.com/download/dotnet)
 * [Releases Index][releases-index.json] -- Index for all release channels in JSON format
-* [dotnet-install scripts](https://docs.microsoft.com/dotnet/core/tools/dotnet-install-script)
-* [Installation docs](https://docs.microsoft.com/dotnet/core/install/)
+* [dotnet-install scripts](https://learn.microsoft.com/dotnet/core/tools/dotnet-install-script)
+* [Installation docs](https://learn.microsoft.com/dotnet/core/install/)
 
 [releases-index.json]: https://dotnetcli.blob.core.windows.net/dotnet/release-metadata/releases-index.json
 [policies]: release-policies.md

bug-bounty-preview-scopes.md

@@ -20,7 +20,7 @@ Read the .NET bug bounty [terms and conditions](https://www.microsoft.com/en-us/
 
 | Feature | Description | Documentation |
 |---------|-------------|---------------|
-| HTTP/3 | HTTP/3 support in the Kestrel Web Server | [Enabling HTTP/3](https://docs.microsoft.com/aspnet/core/fundamentals/servers/kestrel/http3?view=aspnetcore-6.0) |
+| HTTP/3 | HTTP/3 support in the Kestrel Web Server | [Enabling HTTP/3](https://learn.microsoft.com/aspnet/core/fundamentals/servers/kestrel/http3?view=aspnetcore-6.0) |
 
 ## In-scope preview features in nightly builds of the upcoming version (.NET 7)
 

license-information-windows.md

@@ -1,31 +1,31 @@
 # License information for .NET on Windows
 
-The Windows distribution of .NET 5.0 and later releases contains files that are provided under 
+The Windows distribution of .NET 5.0 and later releases contains files that are provided under
 multiple licenses.
-This information is provided to help you understand the license terms that 
+This information is provided to help you understand the license terms that
 apply to your use. By using any or all of these files you agree to their associated license terms.
 
-The following binaries are licensed with the 
-[Windows SDK License](https://docs.microsoft.com/legal/windows-sdk/license):
+The following binaries are licensed with the
+[Windows SDK License](https://learn.microsoft.com/legal/windows-sdk/license):
 
 * api-ms-\*.\* (used by .NET runtime)
 * ucrtbase.dll (used by .NET runtime)
 * D3DCompiler_47_cor3.dll (used by WPF)
 
-The following binaries are licensed with the 
+The following binaries are licensed with the
 [.NET Library License](https://dotnet.microsoft.com/dotnet_library_license.htm)
 
 * PresentationNative_cor3.dll (used by WPF)
 * wpfgfx_cor3.dll (used by WPF)
 
-The following binaries are licensed with the 
-[Visual Studio 2019 License](https://visualstudio.microsoft.com/license-terms/mlt031619/) 
+The following binaries are licensed with the
+[Visual Studio 2019 License](https://visualstudio.microsoft.com/license-terms/mlt031619/)
 (not as a "trial"):
 
 * vcruntime140_cor3.dll (used by WPF)
 * Microsoft.DiaSymReader.Native.{x86|amd64|arm|arm64}.dll (used by .NET SDK)
 
-All other binaries and files are licensed with the 
+All other binaries and files are licensed with the
 [MIT license](https://github.com/dotnet/core/blob/main/LICENSE.TXT)
 
 This document is provided for informative purposes only, and is not itself a license.

product-roadmap/current.md

@@ -62,7 +62,7 @@ Items in each section include the following icons:
 
 ## EF
 
-[EF Core 5.0 plan](https://docs.microsoft.com/ef/core/what-is-new/ef-core-5.0/plan)
+[EF Core 5.0 plan](https://learn.microsoft.com/ef/core/what-is-new/ef-core-5.0/plan)
 
 - ![Completed](media/status-completed.png "Completed icon") Fully transparent many-to-many mapping by convention
 - ![Completed](media/status-completed.png "Completed icon") Many-to-many navigation properties (a.k.a "skip navigations")
@@ -214,21 +214,21 @@ Please see the following links to view work items and themes across:
 -	![In Progress](media/status-in-progress.png "In Progress icon") Keep pace with changes in the underlying OS to ensure compatibility with the latest changes in Win10.
 
 ## Xamarin
-- ![Completed](media/status-completed.png "Completed icon") [Android 11 / API 30 Support](https://docs.microsoft.com/xamarin/android/release-notes/11/11.0)
-- ![Completed](media/status-completed.png "Completed icon") [Android smaller APK sizes](https://docs.microsoft.com/xamarin/android/release-notes/11/11.0#smaller-app-package-sizes)
+- ![Completed](media/status-completed.png "Completed icon") [Android 11 / API 30 Support](https://learn.microsoft.com/xamarin/android/release-notes/11/11.0)
+- ![Completed](media/status-completed.png "Completed icon") [Android smaller APK sizes](https://learn.microsoft.com/xamarin/android/release-notes/11/11.0#smaller-app-package-sizes)
 - ![In Progress](media/status-in-progress.png "In Progress icon") [Xcode 12 and iOS 14 Support](https://github.com/xamarin/xamarin-macios/issues/8931)
 - ![In Progress](media/status-in-progress.png "In Progress icon") Hot Restart for Android
 - ![In Progress](media/status-in-progress.png "In Progress icon") AndroidX and Google Play Services Bindings Updates
 - ![In Progress](media/status-in-progress.png "In Progress icon") .NET 6 Support
 - ![In Planning](media/status-in-planning.png "In Planning icon") Xamarin.Essentials integration to .NET 6 BCL (System namespace)
 
 ### Xamarin.Forms 5
-- ![Completed](media/status-completed.png "Completed icon") [AppTheme aka Dark Mode support](https://docs.microsoft.com/xamarin/xamarin-forms/user-interface/theming/system-theme-changes)
-- ![In Progress](media/status-in-progress.png "In Progress icon") [CarouselView](https://docs.microsoft.com/xamarin/xamarin-forms/user-interface/carouselview/)
-- ![In Progress](media/status-in-progress.png "In Progress icon") [Drag-and-drop Gestures](https://docs.microsoft.com/xamarin/xamarin-forms/app-fundamentals/gestures/drag-and-drop)
-- ![In Progress](media/status-in-progress.png "In Progress icon") [Gradient and Solid Brushes](https://docs.microsoft.com/xamarin/xamarin-forms/user-interface/brushes/)
-- ![In Progress](media/status-in-progress.png "In Progress icon") [Shapes and Paths](https://docs.microsoft.com/xamarin/xamarin-forms/user-interface/shapes/)
-- ![In Progress](media/status-in-progress.png "In Progress icon") [SwipeView](https://docs.microsoft.com/xamarin/xamarin-forms/user-interface/swipeview)
+- ![Completed](media/status-completed.png "Completed icon") [AppTheme aka Dark Mode support](https://learn.microsoft.com/xamarin/xamarin-forms/user-interface/theming/system-theme-changes)
+- ![In Progress](media/status-in-progress.png "In Progress icon") [CarouselView](https://learn.microsoft.com/xamarin/xamarin-forms/user-interface/carouselview/)
+- ![In Progress](media/status-in-progress.png "In Progress icon") [Drag-and-drop Gestures](https://learn.microsoft.com/xamarin/xamarin-forms/app-fundamentals/gestures/drag-and-drop)
+- ![In Progress](media/status-in-progress.png "In Progress icon") [Gradient and Solid Brushes](https://learn.microsoft.com/xamarin/xamarin-forms/user-interface/brushes/)
+- ![In Progress](media/status-in-progress.png "In Progress icon") [Shapes and Paths](https://learn.microsoft.com/xamarin/xamarin-forms/user-interface/shapes/)
+- ![In Progress](media/status-in-progress.png "In Progress icon") [SwipeView](https://learn.microsoft.com/xamarin/xamarin-forms/user-interface/swipeview)
 
 ### Xamarin.Forms vNext (.NET MAUI)
 - ![In Progress](media/status-in-progress.png "In Progress icon") [Slim Renderers](https://github.com/dotnet/maui/issues/28) - performance improvements, decouple from bindable, and introduce interfaces

release-notes/1.0/1.0.0-known-issues.md

@@ -232,6 +232,6 @@ and <https://support.microsoft.com/kb/2790113> but these installations may not
 
 ## Bash on Ubuntu on Windows
 
-[Bash on Windows (WSL)](https://docs.microsoft.com/windows/wsl/about) is not yet supported by .NET Core. Attempting to run applications in the environment can experience intermittent crashes.
+[Bash on Windows (WSL)](https://learn.microsoft.com/windows/wsl/about) is not yet supported by .NET Core. Attempting to run applications in the environment can experience intermittent crashes.
 
 - https://github.com/Microsoft/BashOnWindows/issues/520

release-notes/1.0/1.0.0.md

@@ -2,7 +2,7 @@
 
 ## .NET Core 1.0.0 released 6/27/2016
 
-Details on this release can be read about on the 
+Details on this release can be read about on the
 [.NET Blog](https://blogs.msdn.microsoft.com/dotnet/2016/06/27/announcing-net-core-1-0) and if you haven't already discovered the updated [.NET Portal](https://go.microsoft.com/fwlink/?LinkID=798306), make that your next destination for getting started with .NET Core.
 
 There are a few issues to be aware of, which are described in the [.NET Core 1.0.0 Known Issues](1.0.0-known-issues.md) document.
@@ -43,8 +43,8 @@ No changes from RC2.
 
 ### Introduction of .NET Core API Documentation
 
-* Conceptual: https://docs.microsoft.com/dotnet/articles/core/index
-* API: https://docs.microsoft.com/dotnet/core/api/index
+* Conceptual: https://learn.microsoft.com/dotnet/articles/core/index
+* API: https://learn.microsoft.com/dotnet/core/api/index
 
 ### Production-quality .NET Core Runtime and Framework libraries
 

release-notes/1.0/1.0.1-release-notes.md

@@ -6,7 +6,7 @@ A few highlights on this release can be read about on the [.NET Blog](https://bl
 
 This release coincides with a security advisory for MVC. See the following for additional details.
 
-* [Advisory](https://docs.microsoft.com/security-updates/SecurityAdvisories/2016/3181759)
+* [Advisory](https://learn.microsoft.com/security-updates/SecurityAdvisories/2016/3181759)
 * [Announcement](https://github.com/aspnet/Announcements/issues/203)
 * [Discussion](https://github.com/aspnet/Mvc/issues/5271)
 

release-notes/1.0/RC1-RC2_Upgrade.md

@@ -6,7 +6,7 @@ Due to schedule changes for the .NET Core all-up, there was a rename of the tool
 
 This does not impact RC1 release. Since the tooling and the way you write applications has changed, having DNX (or many of them) installed should not be a problem. However, one caveat is what tooling you are using for what project. For RC2 projects you may get wrong results and/or errors if you try to restore dependencies using `dnu restore`. Please use the appropriate tooling. You can see what are the new commands in the DNX to CLI migration document listed below.
 
-For updating your code, you can check [Migrating from DNX to CLI](https://docs.microsoft.com/dotnet/core/migration/from-dnx).
+For updating your code, you can check [Migrating from DNX to CLI](https://learn.microsoft.com/dotnet/core/migration/from-dnx).
 
 ## Native installers
 

release-notes/1.0/Release-Notes-RC2.md

@@ -37,8 +37,8 @@ A little style note for the rest of this document - any references to 'Unix' enc
 
 ### Introduction of .NET Core API Documentation
 
-* API: https://docs.microsoft.com/dotnet/api/
-* Conceptual: https://docs.microsoft.com/dotnet/
+* API: https://learn.microsoft.com/dotnet/api/
+* Conceptual: https://learn.microsoft.com/dotnet/
 
 ### Runtime
 

release-notes/1.0/cli-known-issues.md

@@ -143,7 +143,7 @@ If you don't get this error on a Windows machine, that is most likely due to the
 
 ## `dotnet test` has changed from Preview 2 `dotnet test`
 As part of the overall Preview 3 work, `dotnet test` command has been been revised and is quite different in usage and behavior then Preview 2 `dotnet test` command. Please consult the official [dotnet test
-docs](https://docs.microsoft.com/dotnet/articles/core/preview3/tools/dotnet-test) for more information and expect more documentation in coming days.
+docs](https://learn.microsoft.com/dotnet/articles/core/preview3/tools/dotnet-test) for more information and expect more documentation in coming days.
 
 # What is this document about?
 This document outlines the known issues and workarounds for the current state of

release-notes/1.0/sdk/1.0-rc3-implicit-package-refs.md

@@ -23,5 +23,5 @@ With this new feature, you might be wondering when you should specify a version
 * For new projects, you should use the template and not add an explicit reference to any metapackage.
 * For existing projects, you should remove the reference.
 * If you need a specific version of the runtime, you should use the `<RuntimeFrameworkVersion>` property in your project (for example, `1.0.4`) instead of referencing the metapackage.
-    * This might happen if you are using [self-contained deployments](https://docs.microsoft.com/dotnet/articles/core/preview3/deploying/#self-contained-deployments-scd) and you need a specific patch version of 1.0.0 LTS runtime, for example.
+    * This might happen if you are using [self-contained deployments](https://learn.microsoft.com/dotnet/articles/core/preview3/deploying/#self-contained-deployments-scd) and you need a specific patch version of 1.0.0 LTS runtime, for example.
 * If you need a specific version of the `NetStandard.Library` metapackage, you can use the `<NetStandardImplicitPackageVersion>` property and set the version you need.

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

@@ -16,7 +16,7 @@ Windows Client                | 7 SP1(**\***), 8.1            | x64, x86       |
 Windows 10 Client             | Version 1607+                 | x64, x86       | 1607 is the minimum version for support. See [Out of support OS versions](#out-of-support-os-versions) below for Windows 10 releases that are no longer supported.
 Windows Server                | 2008 R2 SP1+                  | x64, x86       |
 
-**\*** Windows 7 SP1 is supported with [Extended Security Updates](https://docs.microsoft.com/troubleshoot/windows-client/windows-7-eos-faq/windows-7-extended-security-updates-faq) installed.
+**\*** Windows 7 SP1 is supported with [Extended Security Updates](https://learn.microsoft.com/troubleshoot/windows-client/windows-7-eos-faq/windows-7-extended-security-updates-faq) installed.
 
 See the [Windows Lifecycle Fact Sheet](https://support.microsoft.com/help/13853/windows-lifecycle-fact-sheet) for details regarding each Windows release lifecycle.
 

release-notes/2.1/2.1.0.md

@@ -75,7 +75,7 @@ dotnet build -nodeReuse:false
 
 ### Networking Performance
 
-You can use one of the following mechanisms to configure a process to use the older [HttpClientHandler](https://docs.microsoft.com/dotnet/api/system.net.http.httpclienthandler):
+You can use one of the following mechanisms to configure a process to use the older [HttpClientHandler](https://learn.microsoft.com/dotnet/api/system.net.http.httpclienthandler):
 
 From code, use the AppContext class:
 
@@ -87,7 +87,7 @@ The AppContext switch can also be set by config file.
 
 The same can be achieved via the environment variable `DOTNET_SYSTEM_NET_HTTP_USESOCKETSHTTPHANDLER`. To opt out, set the value to either `false` or `0`.
 
-On Windows, you can choose to use `WinHttpHandler` or `SocketsHttpHandler` on a call-by-call basis. To do that, instantiate one of those types and then pass it to [HttpClient](https://docs.microsoft.com/dotnet/api/system.net.http.httpclient.-ctor) when you instantiate it.
+On Windows, you can choose to use `WinHttpHandler` or `SocketsHttpHandler` on a call-by-call basis. To do that, instantiate one of those types and then pass it to [HttpClient](https://learn.microsoft.com/dotnet/api/system.net.http.httpclient.-ctor) when you instantiate it.
 
 On Linux and macOS, you can only configure `HttpClient` on a process-basis. On Linux, you need to deploy [libcurl](https://curl.haxx.se/libcurl/) yourself if you want to use the old `HttpClient` implementation. If you have .NET Core 2.0 working on your machine, then libcurl is already installed.
 

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

@@ -14,7 +14,7 @@ See the [Release Notes](https://github.com/dotnet/core/blob/main/release-notes/2
 | :-- | :--: |
 | Visual Studio 2017 (Windows) | [2.1.506](#downloads) |
 | Visual Studio 2019 (Windows) | [2.1.603](../2.1.603-SDK/2.1.603-SDK-download.md) |
-| Visual Studio for Mac | https://docs.microsoft.com/visualstudio/mac/net-core-support |
+| Visual Studio for Mac | https://learn.microsoft.com/visualstudio/mac/net-core-support |
 
 ## Downloads
 
@@ -155,7 +155,7 @@ This will install the ASP.NET Core Module for IIS.
 [checksums-runtime]: https://dotnetcli.blob.core.windows.net/dotnet/checksums/2.1.10-runtime-sha.txt
 [checksums-sdk]: https://dotnetcli.blob.core.windows.net/dotnet/checksums/2.1.506-sdk-sha.txt
 
-[linux-install]: https://docs.microsoft.com/dotnet/core/install/linux
+[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

@@ -8,7 +8,7 @@
 | :-- | :--: |
 | Visual Studio 2017 (Windows) | [2.1.506](#downloads) |
 | Visual Studio 2019 (Windows) | [2.1.603](../2.1.603-SDK/2.1.603-SDK-download.md) |
-| Visual Studio for Mac | https://docs.microsoft.com/visualstudio/mac/net-core-support |
+| Visual Studio for Mac | https://learn.microsoft.com/visualstudio/mac/net-core-support |
 
 * [Blog Post][dotnet-blog]
 * [Downloads](#downloads)
@@ -192,6 +192,6 @@ runtime.win-x86.microsoft.netcore.dotnethostresolver | 2.1.10
 [checksums-runtime]: https://dotnetcli.blob.core.windows.net/dotnet/checksums/2.1.10-runtime-sha.txt
 [checksums-sdk]: https://dotnetcli.blob.core.windows.net/dotnet/checksums/2.1.506-sdk-sha.txt
 
-[linux-install]: https://docs.microsoft.com/dotnet/core/install/linux
+[linux-install]: https://learn.microsoft.com/dotnet/core/install/linux
 
 [dotnet-blog]: https://devblogs.microsoft.com/dotnet/net-core-april-2019/