Replace docs.microsoft.com with learn.microsoft.com

.github/ISSUE_TEMPLATE/config.yml

@@ -1,13 +1,13 @@
 blank_issues_enabled: true
 contact_links:
-  - name: docs.microsoft.com site feedback
+  - name: learn.microsoft.com site feedback
     url: https://github.com/MicrosoftDocs/feedback/issues/new/choose
-    about: Log general docs.microsoft.com site issues here
+    about: Log general learn.microsoft.com site issues here
   - name: .NET platform and other product feedback
     url: https://aka.ms/feedback/report?space=61
     about: Log product issues here
   - name: .NET Q&A forums
-    url: https://docs.microsoft.com/answers/products/dotnet
+    url: https://learn.microsoft.com/answers/products/dotnet
     about: Find answers to your technical questions about .NET
   - name: .NET tech community forums
     url: https://techcommunity.microsoft.com/t5/net/ct-p/dotnet

.github/ISSUE_TEMPLATE/doc-issue.md

@@ -12,7 +12,7 @@ assignees: ''
 
 	If the issue is:
 
-	- A simple typo or similar correction, consider submitting a PR to fix it instead of logging an issue. See [the contributor guide](https://docs.microsoft.com/contribute/#quick-edits-to-existing-documents) for instructions.
+	- A simple typo or similar correction, consider submitting a PR to fix it instead of logging an issue. See [the contributor guide](https://learn.microsoft.com/contribute/#quick-edits-to-documentation) for instructions.
 	- A general support question, consider asking on a support forum site.
 	- A site design concern, create an issue at [MicrosoftDocs/feedback](https://github.com/MicrosoftDocs/feedback/issues/new/choose).
 	- A problem completing a tutorial, compare your code with the completed sample.

docs/core/diagnostics/snippets/diagnosticsource/csharp/Program.cs

@@ -3,7 +3,7 @@
 MyListener TheListener = new MyListener();
 TheListener.Listening();
 HTTPClient Client = new HTTPClient();
-Client.SendWebRequest("https://docs.microsoft.com/dotnet/core/diagnostics/");
+Client.SendWebRequest("https://learn.microsoft.com/dotnet/core/diagnostics/");
 
 // <snippit4>
 class HTTPClient

docs/csharp/asynchronous-programming/snippets/access-web/Program.cs

@@ -1,7 +1,7 @@
 class Program
 {
     static async Task Main() =>
-        Console.WriteLine($"docs.microsoft.com/dotnet content length = {await AccessWeb.Example.GetUrlContentLengthAsync()}");
+        Console.WriteLine($"learn.microsoft.com/dotnet content length = {await AccessWeb.Example.GetUrlContentLengthAsync()}");
 }
 
 class AccessWeb
@@ -14,7 +14,7 @@ public async Task<int> GetUrlContentLengthAsync()
         var client = new HttpClient();
 
         Task<string> getStringTask =
-            client.GetStringAsync("https://docs.microsoft.com/dotnet");
+            client.GetStringAsync("https://learn.microsoft.com/dotnet");
 
         DoIndependentWork();
 

docs/csharp/asynchronous-programming/snippets/cancel-tasks/Program.cs

@@ -11,25 +11,25 @@ class Program
 
     static readonly IEnumerable<string> s_urlList = new string[]
     {
-            "https://docs.microsoft.com",
-            "https://docs.microsoft.com/aspnet/core",
-            "https://docs.microsoft.com/azure",
-            "https://docs.microsoft.com/azure/devops",
-            "https://docs.microsoft.com/dotnet",
-            "https://docs.microsoft.com/dynamics365",
-            "https://docs.microsoft.com/education",
-            "https://docs.microsoft.com/enterprise-mobility-security",
-            "https://docs.microsoft.com/gaming",
-            "https://docs.microsoft.com/graph",
-            "https://docs.microsoft.com/microsoft-365",
-            "https://docs.microsoft.com/office",
-            "https://docs.microsoft.com/powershell",
-            "https://docs.microsoft.com/sql",
-            "https://docs.microsoft.com/surface",
-            "https://docs.microsoft.com/system-center",
-            "https://docs.microsoft.com/visualstudio",
-            "https://docs.microsoft.com/windows",
-            "https://docs.microsoft.com/xamarin"
+            "https://learn.microsoft.com",
+            "https://learn.microsoft.com/aspnet/core",
+            "https://learn.microsoft.com/azure",
+            "https://learn.microsoft.com/azure/devops",
+            "https://learn.microsoft.com/dotnet",
+            "https://learn.microsoft.com/dynamics365",
+            "https://learn.microsoft.com/education",
+            "https://learn.microsoft.com/enterprise-mobility-security",
+            "https://learn.microsoft.com/gaming",
+            "https://learn.microsoft.com/graph",
+            "https://learn.microsoft.com/microsoft-365",
+            "https://learn.microsoft.com/office",
+            "https://learn.microsoft.com/powershell",
+            "https://learn.microsoft.com/sql",
+            "https://learn.microsoft.com/surface",
+            "https://learn.microsoft.com/system-center",
+            "https://learn.microsoft.com/visualstudio",
+            "https://learn.microsoft.com/windows",
+            "https://learn.microsoft.com/xamarin"
     };
 
     static async Task Main()

docs/csharp/asynchronous-programming/snippets/multiple-tasks-6-0/Program.cs

@@ -7,25 +7,25 @@
 
 IEnumerable<string> s_urlList = new string[]
 {
-    "https://docs.microsoft.com",
-    "https://docs.microsoft.com/aspnet/core",
-    "https://docs.microsoft.com/azure",
-    "https://docs.microsoft.com/azure/devops",
-    "https://docs.microsoft.com/dotnet",
-    "https://docs.microsoft.com/dynamics365",
-    "https://docs.microsoft.com/education",
-    "https://docs.microsoft.com/enterprise-mobility-security",
-    "https://docs.microsoft.com/gaming",
-    "https://docs.microsoft.com/graph",
-    "https://docs.microsoft.com/microsoft-365",
-    "https://docs.microsoft.com/office",
-    "https://docs.microsoft.com/powershell",
-    "https://docs.microsoft.com/sql",
-    "https://docs.microsoft.com/surface",
-    "https://docs.microsoft.com/system-center",
-    "https://docs.microsoft.com/visualstudio",
-    "https://docs.microsoft.com/windows",
-    "https://docs.microsoft.com/xamarin"
+    "https://learn.microsoft.com",
+    "https://learn.microsoft.com/aspnet/core",
+    "https://learn.microsoft.com/azure",
+    "https://learn.microsoft.com/azure/devops",
+    "https://learn.microsoft.com/dotnet",
+    "https://learn.microsoft.com/dynamics365",
+    "https://learn.microsoft.com/education",
+    "https://learn.microsoft.com/enterprise-mobility-security",
+    "https://learn.microsoft.com/gaming",
+    "https://learn.microsoft.com/graph",
+    "https://learn.microsoft.com/microsoft-365",
+    "https://learn.microsoft.com/office",
+    "https://learn.microsoft.com/powershell",
+    "https://learn.microsoft.com/sql",
+    "https://learn.microsoft.com/surface",
+    "https://learn.microsoft.com/system-center",
+    "https://learn.microsoft.com/visualstudio",
+    "https://learn.microsoft.com/windows",
+    "https://learn.microsoft.com/xamarin"
 };
 
 await SumPageSizesAsync();
@@ -63,25 +63,25 @@ static async Task<int> ProcessUrlAsync(string url, HttpClient client)
 }
 
 // Example output:
-// https://docs.microsoft.com                                      132,517
-// https://docs.microsoft.com/powershell                            57,375
-// https://docs.microsoft.com/gaming                                33,549
-// https://docs.microsoft.com/aspnet/core                           88,714
-// https://docs.microsoft.com/surface                               39,840
-// https://docs.microsoft.com/enterprise-mobility-security          30,903
-// https://docs.microsoft.com/microsoft-365                         67,867
-// https://docs.microsoft.com/windows                               26,816
-// https://docs.microsoft.com/xamarin                               57,958
-// https://docs.microsoft.com/dotnet                                78,706
-// https://docs.microsoft.com/graph                                 48,277
-// https://docs.microsoft.com/dynamics365                           49,042
-// https://docs.microsoft.com/office                                67,867
-// https://docs.microsoft.com/system-center                         42,887
-// https://docs.microsoft.com/education                             38,636
-// https://docs.microsoft.com/azure                                421,663
-// https://docs.microsoft.com/visualstudio                          30,925
-// https://docs.microsoft.com/sql                                   54,608
-// https://docs.microsoft.com/azure/devops                          86,034
+// https://learn.microsoft.com                                      132,517
+// https://learn.microsoft.com/powershell                            57,375
+// https://learn.microsoft.com/gaming                                33,549
+// https://learn.microsoft.com/aspnet/core                           88,714
+// https://learn.microsoft.com/surface                               39,840
+// https://learn.microsoft.com/enterprise-mobility-security          30,903
+// https://learn.microsoft.com/microsoft-365                         67,867
+// https://learn.microsoft.com/windows                               26,816
+// https://learn.microsoft.com/xamarin                               57,958
+// https://learn.microsoft.com/dotnet                                78,706
+// https://learn.microsoft.com/graph                                 48,277
+// https://learn.microsoft.com/dynamics365                           49,042
+// https://learn.microsoft.com/office                                67,867
+// https://learn.microsoft.com/system-center                         42,887
+// https://learn.microsoft.com/education                             38,636
+// https://learn.microsoft.com/azure                                421,663
+// https://learn.microsoft.com/visualstudio                          30,925
+// https://learn.microsoft.com/sql                                   54,608
+// https://learn.microsoft.com/azure/devops                          86,034
 
 // Total bytes returned:    1,454,184
 // Elapsed time:            00:00:01.1290403

docs/csharp/asynchronous-programming/snippets/multiple-tasks/Program.cs

@@ -16,25 +16,25 @@ class Program
 
         static readonly IEnumerable<string> s_urlList = new string[]
         {
-            "https://docs.microsoft.com",
-            "https://docs.microsoft.com/aspnet/core",
-            "https://docs.microsoft.com/azure",
-            "https://docs.microsoft.com/azure/devops",
-            "https://docs.microsoft.com/dotnet",
-            "https://docs.microsoft.com/dynamics365",
-            "https://docs.microsoft.com/education",
-            "https://docs.microsoft.com/enterprise-mobility-security",
-            "https://docs.microsoft.com/gaming",
-            "https://docs.microsoft.com/graph",
-            "https://docs.microsoft.com/microsoft-365",
-            "https://docs.microsoft.com/office",
-            "https://docs.microsoft.com/powershell",
-            "https://docs.microsoft.com/sql",
-            "https://docs.microsoft.com/surface",
-            "https://docs.microsoft.com/system-center",
-            "https://docs.microsoft.com/visualstudio",
-            "https://docs.microsoft.com/windows",
-            "https://docs.microsoft.com/xamarin"
+            "https://learn.microsoft.com",
+            "https://learn.microsoft.com/aspnet/core",
+            "https://learn.microsoft.com/azure",
+            "https://learn.microsoft.com/azure/devops",
+            "https://learn.microsoft.com/dotnet",
+            "https://learn.microsoft.com/dynamics365",
+            "https://learn.microsoft.com/education",
+            "https://learn.microsoft.com/enterprise-mobility-security",
+            "https://learn.microsoft.com/gaming",
+            "https://learn.microsoft.com/graph",
+            "https://learn.microsoft.com/microsoft-365",
+            "https://learn.microsoft.com/office",
+            "https://learn.microsoft.com/powershell",
+            "https://learn.microsoft.com/sql",
+            "https://learn.microsoft.com/surface",
+            "https://learn.microsoft.com/system-center",
+            "https://learn.microsoft.com/visualstudio",
+            "https://learn.microsoft.com/windows",
+            "https://learn.microsoft.com/xamarin"
         };
 
         static Task Main() => SumPageSizesAsync();
@@ -73,25 +73,25 @@ static async Task<int> ProcessUrlAsync(string url, HttpClient client)
     }
 }
 // Example output:
-// https://docs.microsoft.com/windows                               25,513
-// https://docs.microsoft.com/gaming                                30,705
-// https://docs.microsoft.com/dotnet                                69,626
-// https://docs.microsoft.com/dynamics365                           50,756
-// https://docs.microsoft.com/surface                               35,519
-// https://docs.microsoft.com                                       39,531
-// https://docs.microsoft.com/azure/devops                          75,837
-// https://docs.microsoft.com/xamarin                               60,284
-// https://docs.microsoft.com/system-center                         43,444
-// https://docs.microsoft.com/enterprise-mobility-security          28,946
-// https://docs.microsoft.com/microsoft-365                         43,278
-// https://docs.microsoft.com/visualstudio                          31,414
-// https://docs.microsoft.com/office                                42,292
-// https://docs.microsoft.com/azure                                401,113
-// https://docs.microsoft.com/graph                                 46,831
-// https://docs.microsoft.com/education                             25,098
-// https://docs.microsoft.com/powershell                            58,173
-// https://docs.microsoft.com/aspnet/core                           87,763
-// https://docs.microsoft.com/sql                                   53,362
-   
+// https://learn.microsoft.com/windows                               25,513
+// https://learn.microsoft.com/gaming                                30,705
+// https://learn.microsoft.com/dotnet                                69,626
+// https://learn.microsoft.com/dynamics365                           50,756
+// https://learn.microsoft.com/surface                               35,519
+// https://learn.microsoft.com                                       39,531
+// https://learn.microsoft.com/azure/devops                          75,837
+// https://learn.microsoft.com/xamarin                               60,284
+// https://learn.microsoft.com/system-center                         43,444
+// https://learn.microsoft.com/enterprise-mobility-security          28,946
+// https://learn.microsoft.com/microsoft-365                         43,278
+// https://learn.microsoft.com/visualstudio                          31,414
+// https://learn.microsoft.com/office                                42,292
+// https://learn.microsoft.com/azure                                401,113
+// https://learn.microsoft.com/graph                                 46,831
+// https://learn.microsoft.com/education                             25,098
+// https://learn.microsoft.com/powershell                            58,173
+// https://learn.microsoft.com/aspnet/core                           87,763
+// https://learn.microsoft.com/sql                                   53,362
+
 // Total bytes returned: 1,249,485
 // Elapsed time:          00:00:02.7068725

docs/csharp/language-reference/operators/snippets/shared/AwaitOperator.cs

@@ -18,7 +18,7 @@ private static async Task<int> DownloadDocsMainPageAsync()
         Console.WriteLine($"{nameof(DownloadDocsMainPageAsync)}: About to start downloading.");
 
         var client = new HttpClient();
-        byte[] content = await client.GetByteArrayAsync("https://docs.microsoft.com/en-us/");
+        byte[] content = await client.GetByteArrayAsync("https://learn.microsoft.com/en-us/");
 
         Console.WriteLine($"{nameof(DownloadDocsMainPageAsync)}: Finished downloading.");
         return content.Length;

docs/csharp/language-reference/xmldoc/snippets/xmldoc/DocComments.cs

@@ -10,7 +10,7 @@ namespace XmlTags
     /// </summary>
     /// <remarks>
     /// You can expand on that one sentence summary to
-    /// provide more information for readers. In this case, 
+    /// provide more information for readers. In this case,
     /// the <c>ExampleClass</c> provides different C#
     /// elements to show how you would add documentation
     ///comments for most elements in a typical class.
@@ -81,7 +81,7 @@ namespace XmlTags
     /// also use the "bullet" or "number" style. Neither
     /// would typically use the "term" element.
     /// <br/>
-    /// Note: paragraphs are double spaced. Use the *br* 
+    /// Note: paragraphs are double spaced. Use the *br*
     /// tag for single spaced lines.
     /// </para>
     /// </remarks>
@@ -127,11 +127,11 @@ public string? Label
         /// </code>
         /// </example>
         /// <exception cref="System.OverflowException">
-        /// Thrown when one parameter is 
+        /// Thrown when one parameter is
         /// <see cref="Int32.MaxValue">MaxValue</see> and the other is
         /// greater than 0.
-        /// Note that here you can also use 
-        /// <see href="https://docs.microsoft.com/dotnet/api/system.int32.maxvalue"/>
+        /// Note that here you can also use
+        /// <see href="https://learn.microsoft.com/dotnet/api/system.int32.maxvalue"/>
         ///  to point a web page instead.
         /// </exception>
         /// <see cref="ExampleClass"/> for a list of all
@@ -175,7 +175,7 @@ namespace InheritDoc
     /// </summary>
     /// <remarks>
     /// These remarks would explain more about this class.
-    /// In this example, these comments also explain the 
+    /// In this example, these comments also explain the
     /// general information about the derived class.
     /// </remarks>
     public class MainClass
@@ -194,16 +194,16 @@ public class DerivedClass : MainClass
     /// <remarks>
     /// While elided for brevity, each method or property
     /// in this interface would contain docs that you want
-    /// to duplicate in each implementing class. 
+    /// to duplicate in each implementing class.
     /// </remarks>
     public interface ITestInterface
     {
         /// <summary>
         /// This method is part of the test interface.
         /// </summary>
         /// <remarks>
-        /// This content would be inherited by classes 
-        /// that implement this interface when the 
+        /// This content would be inherited by classes
+        /// that implement this interface when the
         /// implementing class uses "inheritdoc"
         /// </remarks>
         /// <returns>The value of <paramref name="arg" /> </returns>

docs/csharp/tour-of-csharp/snippets/shared/Features.cs

@@ -51,10 +51,10 @@ public string Topic
 // </DefineAttribute>
 
 // <UseAttributes>
-[Help("https://docs.microsoft.com/dotnet/csharp/tour-of-csharp/features")]
+[Help("https://learn.microsoft.com/dotnet/csharp/tour-of-csharp/features")]
 public class Widget
 {
-    [Help("https://docs.microsoft.com/dotnet/csharp/tour-of-csharp/features",
+    [Help("https://learn.microsoft.com/dotnet/csharp/tour-of-csharp/features",
     Topic = "Display")]
     public void Display(string text) { }
 }
@@ -88,7 +88,7 @@ public static void Examples()
     public async Task<int> RetrieveDocsHomePage()
     {
         var client = new HttpClient();
-        byte[] content = await client.GetByteArrayAsync("https://docs.microsoft.com/");
+        byte[] content = await client.GetByteArrayAsync("https://learn.microsoft.com/");
 
         Console.WriteLine($"{nameof(RetrieveDocsHomePage)}: Finished downloading.");
         return content.Length;

docs/fundamentals/networking/snippets/misc/Program.Uri.cs

@@ -4,14 +4,14 @@ static void CanonicalUri()
     {
         // <canonicaluri>
         const string uriString =
-            "https://docs.microsoft.com/en-us/dotnet/path?key=value#bookmark";
+            "https://learn.microsoft.com/en-us/dotnet/path?key=value#bookmark";
 
         Uri canonicalUri = new(uriString);
         Console.WriteLine(canonicalUri.Host);
         Console.WriteLine(canonicalUri.PathAndQuery);
         Console.WriteLine(canonicalUri.Fragment);
         // Sample output:
-        //     docs.microsoft.com
+        //     learn.microsoft.com
         //     /en-us/dotnet/path?key=value
         //     #bookmark
         // </canonicaluri>