Skip to content

Commit c37ee91

Browse files
authored
Changed docs.microsoft.com links to learn.microsoft.com Issue: dotnet#44175 (dotnet#46206)
Updated links from microsoft.docs.* to microsoft.learn.* - fixes dotnet#44175 - also remove version info from the URIs
1 parent 66393ba commit c37ee91

File tree

101 files changed

+127
-127
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

101 files changed

+127
-127
lines changed

.azure/pipelines/blazor-daily-tests.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# Uses Scheduled Triggers, which aren't supported in YAML yet.
2-
# https://docs.microsoft.com/en-us/azure/devops/pipelines/build/triggers?view=vsts&tabs=yaml#scheduled
2+
# https://learn.microsoft.com/en-us/azure/devops/pipelines/build/triggers?view=vsts&tabs=yaml#scheduled
33

44
# Daily Tests for Blazor
55
# These use Sauce Labs resources, hence they run daily rather than per-commit.

.azure/pipelines/ci.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
#
2-
# See https://docs.microsoft.com/en-us/vsts/pipelines/yaml-schema for details on this file.
2+
# See https://learn.microsoft.com/en-us/azure/devops/pipelines/yaml-schema for details on this file.
33
#
44

55
# Configure which branches trigger builds

.azure/pipelines/components-e2e-tests.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
#
2-
# See https://docs.microsoft.com/en-us/vsts/pipelines/yaml-schema for details on this file.
2+
# See https://learn.microsoft.com/en-us/azure/devops/pipelines/yaml-schema for details on this file.
33
#
44

55
# Configure which branches trigger builds

.azure/pipelines/devBuilds.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
#
2-
# See https://docs.microsoft.com/en-us/vsts/pipelines/yaml-schema for details on this file.
2+
# See https://learn.microsoft.com/en-us/azure/devops/pipelines/yaml-schema for details on this file.
33
#
44

55
# Configure which branches trigger builds

.azure/pipelines/jobs/default-build.yml

+2-2
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@
2626
# publishOnError: boolean
2727
# Should artifacts be published if previous step failed?
2828
# dependsOn: string | [ string ]
29-
# For fan-out/fan-in. https://docs.microsoft.com/en-us/azure/devops/pipelines/yaml-schema?view=azure-devops&tabs=schema#job
29+
# For fan-out/fan-in. https://learn.microsoft.com/en-us/azure/devops/pipelines/yaml-schema?view=azure-devops&tabs=schema#job
3030
# condition: string
3131
# A condition which can be used to skip the job completely
3232
# codeSign: boolean
@@ -43,7 +43,7 @@
4343
# variables: [array]
4444
# Job-specific variables. Defined using either name/value pairs or a variable list (using name or group syntax).
4545
#
46-
# See https://docs.microsoft.com/en-us/vsts/pipelines/yaml-schema for details
46+
# See https://learn.microsoft.com/en-us/azure/devops/pipelines/yaml-schema for details
4747
#
4848

4949
parameters:

.azure/pipelines/localization.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
#
2-
# See https://docs.microsoft.com/en-us/vsts/pipelines/yaml-schema for details on this file.
2+
# See https://learn.microsoft.com/en-us/azure/devops/pipelines/yaml-schema for details on this file.
33
#
44

55
schedules:

.azure/pipelines/quarantined-pr.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
#
2-
# See https://docs.microsoft.com/en-us/vsts/pipelines/yaml-schema for details on this file.
2+
# See https://learn.microsoft.com/en-us/azure/devops/pipelines/yaml-schema for details on this file.
33
#
44

55
# Configure which branches trigger builds

.azure/pipelines/richnav.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
#
2-
# See https://docs.microsoft.com/en-us/vsts/pipelines/yaml-schema for details on this file.
2+
# See https://learn.microsoft.com/en-us/azure/devops/pipelines/yaml-schema for details on this file.
33
#
44

55
# Configure which branches trigger builds

.azure/pipelines/signalr-daily-tests.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# Uses Scheduled Triggers, which aren't supported in YAML yet.
2-
# https://docs.microsoft.com/en-us/azure/devops/pipelines/build/triggers?view=vsts&tabs=yaml#scheduled
2+
# https://learn.microsoft.com/en-us/azure/devops/pipelines/build/triggers?view=vsts&tabs=yaml#scheduled
33

44
# Daily Tests for ASP.NET Core SignalR
55
# These use Sauce Labs resources, hence they run daily rather than per-commit.

.editorconfig

+1-1
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
;
55
; Here are some resources for what's supported for .NET/C#
66
; https://kent-boogaart.com/blog/editorconfig-reference-for-c-developers
7-
; https://docs.microsoft.com/en-us/visualstudio/ide/editorconfig-code-style-settings-reference?view=vs-2017
7+
; https://learn.microsoft.com/en-us/visualstudio/ide/editorconfig-code-style-settings-reference
88
;
99
; Be **careful** editing this because some of the rules don't support adding a severity level
1010
; For instance if you change to `dotnet_sort_system_directives_first = true:warning` (adding `:warning`)

.github/fabricbot.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -2652,7 +2652,7 @@
26522652
{
26532653
"name": "addReply",
26542654
"parameters": {
2655-
"comment": "Thanks for contacting us.\nIt looks like this issue is related to debugging in Blazor WebAssembly application.\nBecause there are different components involved in providing debugging experience, we've put together a small troubleshooting guide that you can follow, to help us better understand where to direct this issue to, to get a faster resolution.\nYou can find it [here](https://docs.microsoft.com/en-us/aspnet/core/blazor/debug?view=aspnetcore-5.0&tabs=visual-studio#troubleshoot).\nIf these troubleshooting docs resolve your problem, please close the issue. Otherwise we'll follow up."
2655+
"comment": "Thanks for contacting us.\nIt looks like this issue is related to debugging in Blazor WebAssembly application.\nBecause there are different components involved in providing debugging experience, we've put together a small troubleshooting guide that you can follow, to help us better understand where to direct this issue to, to get a faster resolution.\nYou can find it [here](https://learn.microsoft.com/en-us/aspnet/core/blazor/debug?tabs=visual-studio#troubleshoot).\nIf these troubleshooting docs resolve your problem, please close the issue. Otherwise we'll follow up."
26562656
}
26572657
}
26582658
]

README.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -5,11 +5,11 @@ ASP.NET Core
55
[![MIT License](https://img.shields.io/github/license/dotnet/aspnetcore?color=%230b0&style=flat-square)](https://github.com/dotnet/aspnetcore/blob/main/LICENSE.txt) [![Help Wanted](https://img.shields.io/github/issues/dotnet/aspnetcore/help%20wanted?color=%232EA043&label=help%20wanted&style=flat-square)](https://github.com/dotnet/aspnetcore/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) [![Good First Issues](https://img.shields.io/github/issues/dotnet/aspnetcore/good%20first%20issue?color=%23512BD4&label=good%20first%20issue&style=flat-square)](https://github.com/dotnet/aspnetcore/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)
66
[![Discord](https://img.shields.io/discord/732297728826277939?style=flat-square&label=Discord&logo=discord&logoColor=white&color=7289DA)](https://aka.ms/dotnet-discord)
77

8-
ASP.NET Core is an open-source and cross-platform framework for building modern cloud-based internet-connected applications, such as web apps, IoT apps and mobile backends. ASP.NET Core apps run on [.NET](https://dot.net), a free, cross-platform and open-source application runtime. It was architected to provide an optimized development framework for apps that are deployed to the cloud or run on-premises. It consists of modular components with minimal overhead, so you retain flexibility while constructing your solutions. You can develop and run your ASP.NET Core apps cross-platform on Windows, Mac and Linux. [Learn more about ASP.NET Core](https://docs.microsoft.com/aspnet/core/).
8+
ASP.NET Core is an open-source and cross-platform framework for building modern cloud-based internet-connected applications, such as web apps, IoT apps and mobile backends. ASP.NET Core apps run on [.NET](https://dot.net), a free, cross-platform and open-source application runtime. It was architected to provide an optimized development framework for apps that are deployed to the cloud or run on-premises. It consists of modular components with minimal overhead, so you retain flexibility while constructing your solutions. You can develop and run your ASP.NET Core apps cross-platform on Windows, Mac and Linux. [Learn more about ASP.NET Core](https://learn.microsoft.com/aspnet/core/).
99

1010
## Get started
1111

12-
Follow the [Getting Started](https://docs.microsoft.com/aspnet/core/getting-started) instructions in the [ASP.NET Core docs](https://docs.microsoft.com/aspnet/index).
12+
Follow the [Getting Started](https://learn.microsoft.com/aspnet/core/getting-started) instructions.
1313

1414
Also check out the [.NET Homepage](https://www.microsoft.com/net) for released versions of .NET, getting started guides, and learning resources.
1515

@@ -35,7 +35,7 @@ Security issues and bugs should be reported privately, via email, to the Microso
3535

3636
These are some other repos for related projects:
3737

38-
* [Documentation](https://github.com/aspnet/Docs) - documentation sources for https://docs.microsoft.com/aspnet/core/
38+
* [Documentation](https://github.com/aspnet/Docs) - documentation sources for https://learn.microsoft.com/aspnet/core/
3939
* [Entity Framework Core](https://github.com/dotnet/efcore) - data access technology
4040
* [Runtime](https://github.com/dotnet/runtime) - cross-platform runtime for cloud, mobile, desktop, and IoT apps
4141
* [Razor](https://github.com/dotnet/razor) - the Razor compiler and tooling for working with Razor syntax (.cshtml, .razor)

activate.ps1

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
#
22
# This file must be used by invoking ". .\activate.ps1" from the command line.
3-
# You cannot run it directly. See https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_scripts#script-scope-and-dot-sourcing
3+
# You cannot run it directly. See https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_scripts#script-scope-and-dot-sourcing
44
#
55
# To exit from the environment this creates, execute the 'deactivate' function.
66
#

docs/AddingNewProjects.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -51,4 +51,4 @@ while the second (the one with condition `'$(BuildMainlyReferenceProviders)' ==
5151
3. Add your project name to the lists in `src\Framework\test\TestData.cs`. This is not strictly necessary for the project to work but there is a test on CI that will fail if this is not done. Make sure to include your project in a way that maintains alphabetical ordering.
5252
5353
## Manually saving solution and solution filter files
54-
VS is pretty good at keeping the files up to date and organized correctly. It will also prompt you if it finds an error and, in most cases, offer a solution to fix the issue. Sometimes just saving the file will trigger VS to resolve any issues automatically. However, if you would like to add a new solution filter file or update one manually you can find a tutorial link [here](https://docs.microsoft.com/en-us/visualstudio/ide/filtered-solutions?view=vs-2022).
54+
VS is pretty good at keeping the files up to date and organized correctly. It will also prompt you if it finds an error and, in most cases, offer a solution to fix the issue. Sometimes just saving the file will trigger VS to resolve any issues automatically. However, if you would like to add a new solution filter file or update one manually you can find a tutorial link [here](https://learn.microsoft.com/en-us/visualstudio/ide/filtered-solutions).

docs/BuildErrors.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -81,7 +81,7 @@ To resolve this issue, confirm that you've installed the required C++ components
8181

8282
## Error: HTTP Error 500.33 - ANCM Request Handler Load Failure
8383

84-
The [ASP.NET Core Module](https://docs.microsoft.com/aspnet/core/host-and-deploy/aspnet-core-module) (ANCM) for IIS is not supported when running projects in this repository.
84+
The [ASP.NET Core Module](https://learn.microsoft.com/aspnet/core/host-and-deploy/aspnet-core-module) (ANCM) for IIS is not supported when running projects in this repository.
8585

8686
After using `startvs.cmd` to open a solution in Visual Studio, the Kestrel web host option must be used (name of the project) and not IIS Express.
8787

docs/BuildFromSource.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ To get started, fork this repo and then clone it locally. This workflow assumes
2020
2121
> :bulb: All other steps below will be against your fork of the aspnetcore repo (e.g. `YOUR_USERNAME/aspnetcore`), not the official `dotnet/aspnetcore` repo.
2222
23-
1. If you're on Windows, update the PowerShell execution policy on your machine. For more information on execution policies, review [the execution policy docs](https://docs.microsoft.com/powershell/module/microsoft.powershell.security/set-executionpolicy). To do this, open a PowerShell prompt and issue the following command:
23+
1. If you're on Windows, update the PowerShell execution policy on your machine. For more information on execution policies, review [the execution policy docs](https://learn.microsoft.com/powershell/module/microsoft.powershell.security/set-executionpolicy). To do this, open a PowerShell prompt and issue the following command:
2424

2525
```powershell
2626
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
@@ -40,7 +40,7 @@ The steps you follow next depend on your preferred development environment:
4040

4141
> :warning: Even if you have Visual Studio installed on your machine, we recommend running this installation script to make sure that the correct Visual Studio components are installed.
4242
>
43-
> To modify an existing Visual Studio installation, [follow the instructions for installing from a configuration file](https://learn.microsoft.com/visualstudio/install/import-export-installation-configurations?view=vs-2022#import-a-configuration) and use the `.vsconfig` file located in the root of the repository:
43+
> To modify an existing Visual Studio installation, [follow the instructions for installing from a configuration file](https://learn.microsoft.com/visualstudio/install/import-export-installation-configurations#import-a-configuration) and use the `.vsconfig` file located in the root of the repository:
4444

4545
```powershell
4646
./eng/scripts/InstallVisualStudio.ps1
@@ -64,7 +64,7 @@ The steps you follow next depend on your preferred development environment:
6464
6565
We have a single _.sln_ file for all of ASP.NET Core, but most people don't work with it directly because Visual Studio doesn't currently handle projects of this scale very well.
6666
67-
Instead, we have many Solution Filter (.slnf) files which include a sub-set of projects. For more information on solution files, you can review the [official Visual Studio doc](https://docs.microsoft.com/visualstudio/ide/filtered-solutions).
67+
Instead, we have many Solution Filter (.slnf) files which include a sub-set of projects. For more information on solution files, you can review the [official Visual Studio doc](https://learn.microsoft.com/visualstudio/ide/filtered-solutions).
6868
6969
These principles guide how we create and manage .slnf files:
7070
@@ -74,7 +74,7 @@ The steps you follow next depend on your preferred development environment:
7474

7575
</details>
7676

77-
1. You can now build, debug, and test using Visual Studio. For more information on using Visual Studio to build and run projects, you can review the [official Visual Studio docs](https://docs.microsoft.com/visualstudio/get-started/csharp/run-program).
77+
1. You can now build, debug, and test using Visual Studio. For more information on using Visual Studio to build and run projects, you can review the [official Visual Studio docs](https://learn.microsoft.com/visualstudio/get-started/csharp/run-program).
7878

7979
## Visual Studio Code or other editor on Windows, Linux, Mac
8080

docs/Trimming.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
This guide discusses the steps required to enable, annotate, and verify trimming in ASP.NET Core assemblies. An assembly that supports trimming knows all the types and members it needs at runtime. Unused code is removed when an app is published, reducing app size. Trimming is also a precursor to supporting AOT, which requires knowledge of the APIs used by an app on build.
44

5-
[Trim self-contained deployments and executables](https://docs.microsoft.com/dotnet/core/deploying/trimming/trim-self-contained) has general documentation for trimming. It includes:
5+
[Trim self-contained deployments and executables](https://learn.microsoft.com/dotnet/core/deploying/trimming/trim-self-contained) has general documentation for trimming. It includes:
66

77
* How to output trim warnings. Typically done by publishing an app.
88
* How to react to trim warnings. Attributes can be placed on APIs to provide type info, suppress warnings, or verify that an API is incompatible with trimming.
@@ -30,7 +30,7 @@ The first step to trimming an ASP.NET Core assembly is adding it to `Linkability
3030

3131
## Fix trim warnings
3232

33-
[Introduction to trim warnings](https://docs.microsoft.com/en-us/dotnet/core/deploying/trimming/fixing-warnings) and [Prepare .NET libraries for trimming](https://docs.microsoft.com/dotnet/core/deploying/trimming/prepare-libraries-for-trimming) discuss how to fix trim warnings. There is also a complete list of all the trim warnings with some more detail.
33+
[Introduction to trim warnings](https://learn.microsoft.com/en-us/dotnet/core/deploying/trimming/fixing-warnings) and [Prepare .NET libraries for trimming](https://learn.microsoft.com/dotnet/core/deploying/trimming/prepare-libraries-for-trimming) discuss how to fix trim warnings. There is also a complete list of all the trim warnings with some more detail.
3434

3535
## Updating the baselines
3636

docs/UpdatingMajorVersionAndTFM.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ Typically, we will update the Major Version before updating the TFM. This is bec
1818
* In [src/Framework/test/TestData.cs](/src/Framework/test/TestData.cs), update `ListedTargetingPackAssemblies` by incrementing the AssemblyVersion of all aspnetcore assemblies by 1 major version. Once dotnet/runtime updates their AssemblyVersions, we also need to update those in this file. They typically make that change at the same time as their TFM update, but we change our AssemblyVersions as soon as we update branding.
1919
* Add entries to [NuGet.config](/NuGet.config) for the new Major Version's feed. This just means copying the current feeds (e.g. `dotnet8` and `dotnet8-transport`) and adding entries for the new feeds (`dotnet9` and `dotnet9-transport`). Make an effort to remove old feeds here at the same time.
2020
* In [src/ProjectTemplates/Shared/TemplatePackageInstaller.cs](/src/ProjectTemplates/Shared/TemplatePackageInstaller.cs), add entries to `_templatePackages ` for `Microsoft.DotNet.Web.ProjectTemplates` and `Microsoft.DotNet.Web.Spa.ProjectTemplates` matching the new version.
21-
* In [eng/targets/CSharp.Common.props](/eng/targets/CSharp.Common.props) for the previous release branch, modify the `<LangVersion>` to be a hardcoded version instead of `preview`. (e.g. If main is being updated to 8.0.0 modify the `<LangVersion>` in the release/7.0 branch). See https://docs.microsoft.com/dotnet/csharp/language-reference/configure-language-version#defaults to find what language version to use.
21+
* In [eng/targets/CSharp.Common.props](/eng/targets/CSharp.Common.props) for the previous release branch, modify the `<LangVersion>` to be a hardcoded version instead of `preview`. (e.g. If main is being updated to 8.0.0 modify the `<LangVersion>` in the release/7.0 branch). See https://learn.microsoft.com/dotnet/csharp/language-reference/configure-language-version#defaults to find what language version to use.
2222
* Mark APIs from the previous release as Shipped by running `.\eng\scripts\mark-shipped.cmd`. **Note that it's best to do this as early as possible after the API surface is finalized from the previous release** - make sure to be careful that any new API in `main` that isn't shipped as part of the previous release, stays in `PublicAPI.Unshipped.txt` files.
2323
* One way to ensure this is to check out the release branch shipping the previous release (**after API surface area has been finalized**), run `.\eng\scripts\mark-shipped.cmd` there, copy over all of the `PublicAPI.Unshipped.txt` and `PublicAPI.Shipped.txt` files into a new branch based off of `main`, and build the repo. Any failures there will tell you whether or not there are new APIs in main that need to be put back into the `PublicAPI.Unshipped.txt` files.
2424
* The result of `.\eng\scripts\mark-shipped.cmd` should be checked in to the release branch as well, as part of the RTM release.

eng/SourceBuild.props

+1-1
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@
1616
<!--
1717
Remove inner source .globalconfig file as both the inner and outer config files get loaded and cause a conflict.
1818
Leaving the inner will cause all conflicting settings to be ignored.
19-
https://docs.microsoft.com/en-us/dotnet/fundamentals/code-analysis/configuration-files#general-options
19+
https://learn.microsoft.com/en-us/dotnet/fundamentals/code-analysis/configuration-files#general-options
2020
-->
2121
<Target Name="RemoveInnerGlobalConfig"
2222
DependsOnTargets="PrepareInnerSourceBuildRepoRoot"

0 commit comments

Comments
 (0)