Skip to content

Commit 52bfa8c

Browse files
authored
Update docs.microsoft.com to learn.microsoft.com. (#14774)
* Update docs.microsoft.com to learn.microsoft.com. * Correct links in FSharp.Core. * Scrub en-us
1 parent 5e2fee3 commit 52bfa8c

Some content is hidden

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

51 files changed

+759
-759
lines changed

DEVGUIDE.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -247,7 +247,7 @@ Where `<version>` corresponds to the latest Visual Studio version on your machin
247247

248248
* Coding conventions vary from file to file
249249

250-
* Format using [the F# style guide](https://docs.microsoft.com/en-us/dotnet/fsharp/style-guide/)
250+
* Format using [the F# style guide](https://learn.microsoft.com/dotnet/fsharp/style-guide/)
251251

252252
* Avoid tick identifiers like `body'`. They are generally harder to read and can't be inspected in the debugger as things stand. Generally use R suffix instead, e.g. `bodyR`. The R can stand for "rewritten" or "result"
253253

@@ -427,4 +427,4 @@ See the "Debugging The Compiler" section of this [article](https://medium.com/@w
427427
428428
If you are behind a proxy server, NuGet client tool must be configured to use it:
429429
430-
See the Nuget config file documention for use with a proxy server [https://docs.microsoft.com/en-us/nuget/reference/nuget-config-file](https://docs.microsoft.com/en-us/nuget/reference/nuget-config-file)
430+
See the Nuget config file documention for use with a proxy server [https://learn.microsoft.com/nuget/reference/nuget-config-file](https://learn.microsoft.com/nuget/reference/nuget-config-file)

README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ After it's finished, open `FSharp.sln` in your editor of choice.
4747

4848
### Documentation for F# community
4949

50-
* [The F# Documentation](https://docs.microsoft.com/dotnet/fsharp/) is the primary documentation for F#. The source for the content is [here](https://github.com/dotnet/docs/tree/main/docs/fsharp).
50+
* [The F# Documentation](https://learn.microsoft.com/dotnet/fsharp/) is the primary documentation for F#. The source for the content is [here](https://github.com/dotnet/docs/tree/main/docs/fsharp).
5151

5252
* [The F# Language Design Process](https://github.com/fsharp/fslang-design/) is the fundamental design process for the language, from [suggestions](https://github.com/fsharp/fslang-suggestions) to completed RFCs. There are also [tooling RFCs](https://github.com/fsharp/fslang-design/tree/main/tooling) for some topics where cross-community co-operation and visibility is most useful.
5353

@@ -106,7 +106,7 @@ Additionally, you can use the `#fsharp` tag on Twitter if you have general F# qu
106106

107107
If you're curious about F# itself, check out these links:
108108

109-
* [What is F#](https://docs.microsoft.com/dotnet/fsharp/what-is-fsharp)
110-
* [Get started with F#](https://docs.microsoft.com/dotnet/fsharp/get-started/)
109+
* [What is F#](https://learn.microsoft.com/dotnet/fsharp/what-is-fsharp)
110+
* [Get started with F#](https://learn.microsoft.com/dotnet/fsharp/get-started/)
111111
* [F# Software Foundation](https://fsharp.org)
112112
* [F# Testimonials](https://fsharp.org/testimonials)

TESTGUIDE.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -228,7 +228,7 @@ When you switch branches, certain temporary files, as well as the .NET version (
228228
git clean -xdf -e .vs
229229
```
230230

231-
If you get "file in use" errors during cleaning, make sure to close Visual Studio and any running `dotnet.exe` and `VBCSCompiler.exe`, esp those that show up at the bottom of [Process Explorer](https://docs.microsoft.com/en-us/sysinternals/downloads/process-explorer) without parent process.
231+
If you get "file in use" errors during cleaning, make sure to close Visual Studio and any running `dotnet.exe` and `VBCSCompiler.exe`, esp those that show up at the bottom of [Process Explorer](https://learn.microsoft.com/sysinternals/downloads/process-explorer) without parent process.
232232

233233
#### Running tests on release/dev16.6 etc branches
234234

@@ -250,7 +250,7 @@ The following are common errors that users have encountered while running tests
250250

251251
### Error that a file cannot be accessed
252252

253-
The build often leaves dangling processes like `HostedCompilerServer.exe`, `VBCSCompiler.exe` or `MSBuild.exe`. In [Process Explorer](https://docs.microsoft.com/en-us/sysinternals/downloads/process-explorer) you can see these processes having no parent process anymore. You can also use this to kill such processes. A typical error looks like and contains the process IDs (here 23152, 25252 and 24704):
253+
The build often leaves dangling processes like `HostedCompilerServer.exe`, `VBCSCompiler.exe` or `MSBuild.exe`. In [Process Explorer](https://learn.microsoft.com/sysinternals/downloads/process-explorer) you can see these processes having no parent process anymore. You can also use this to kill such processes. A typical error looks like and contains the process IDs (here 23152, 25252 and 24704):
254254

255255
> C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\MSBuild\Current\Bin\Microsoft.Common.CurrentVersion.targets(4364,5): error MSB3026: Could not copy "D:\Projects\FSharp\artifacts\bin\FSharp.Core\Debug\net45\FSharp.Core.dll" to "D:\Projects\FSharp\tests\fsharpqa\testenv\bin\FSharp.Core.dll". Beginning retry 1 in 1000ms. The process cannot access the file 'D:\Projects\FSharp\tests\fsharpqa\testenv\bin\FSharp.Core.dll' because it is being used by another process. The file is locked by: "HostedCompilerServer (23152), HostedCompilerServer (25252), HostedCompilerServer (24704)" [D:\Projects\OpenSource\FSharp\tests\fsharpqa\testenv\src\ILComparer\ILComparer.fsproj]
256256

docs/debug-emit.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -310,7 +310,7 @@ Breakpoints tend to be less problematic.
310310
311311
### FeeFee and F00F00 debug points (Hidden and JustMyCodeWithNoSource)
312312

313-
Some fragments of code use constructs generate calls and other IL code that should not have debug points and not participate in "Step Into", for example. These are generated in IlxGen as "FeeFee" debug points. See the [the Portable PDB spec linked here](https://docs.microsoft.com/en-us/dotnet/api/system.reflection.metadata.sequencepoint.hiddenline?view=net-5.0).
313+
Some fragments of code use constructs generate calls and other IL code that should not have debug points and not participate in "Step Into", for example. These are generated in IlxGen as "FeeFee" debug points. See the [the Portable PDB spec linked here](https://learn.microsoft.com/dotnet/api/system.reflection.metadata.sequencepoint.hiddenline?view=net-5.0).
314314

315315
> TODO: There is also the future prospect of generating `JustMyCodeWithNoSource` (0xF00F00) debug points but these are not yet emitted by F#. We should check what this is and when the C# compiler emits these.
316316

docs/fcs/interactive.fsx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -273,7 +273,7 @@ Evaluating code in using FsiEvaluationSession generates a .NET dynamic assembly
273273
You can make generated code collectible by passing `collectible=true`. However, code will only
274274
be collected if there are no outstanding object references involving types, for example
275275
`FsiValue` objects returned by `EvalExpression`, and you must have disposed the `FsiEvaluationSession`.
276-
See also [Restrictions on Collectible Assemblies](https://docs.microsoft.com/en-us/previous-versions/dotnet/netframework-4.0/dd554932(v=vs.100)#restrictions).
276+
See also [Restrictions on Collectible Assemblies](https://learn.microsoft.com/previous-versions/dotnet/netframework-4.0/dd554932(v=vs.100)#restrictions).
277277
278278
The example below shows the creation of 200 evaluation sessions. Note that `collectible=true` and
279279
`use session = ...` are both used.

docs/fsharp-core-notes.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -96,7 +96,7 @@ If you do have an explicit FSharp.Core reference in your C# project that you **n
9696

9797
## Guidance for older projects, compilers, and tools
9898

99-
Modern .NET development, including F#, uses SDK-style projects. You can read about that here: https://docs.microsoft.com/dotnet/core/project-sdk/overview
99+
Modern .NET development, including F#, uses SDK-style projects. You can read about that here: https://learn.microsoft.com/dotnet/core/project-sdk/overview
100100

101101
If you are not using SDK-style projects F# projects and/or have an older toolset, the following guidance applies.
102102

eng/common/templates/job/job.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
# and some (Microbuild) should only be applied to non-PR cases for internal builds.
33

44
parameters:
5-
# Job schema parameters - https://docs.microsoft.com/en-us/azure/devops/pipelines/yaml-schema?view=vsts&tabs=schema#job
5+
# Job schema parameters - https://learn.microsoft.com/azure/devops/pipelines/yaml-schema?view=vsts&tabs=schema#job
66
cancelTimeoutInMinutes: ''
77
condition: ''
88
container: ''

eng/common/templates/job/onelocbuild.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ parameters:
22
# Optional: dependencies of the job
33
dependsOn: ''
44

5-
# Optional: A defined YAML pool - https://docs.microsoft.com/en-us/azure/devops/pipelines/yaml-schema?view=vsts&tabs=schema#pool
5+
# Optional: A defined YAML pool - https://learn.microsoft.com/azure/devops/pipelines/yaml-schema?view=vsts&tabs=schema#pool
66
pool: ''
77

88
CeapexPat: $(dn-bot-ceapex-package-r) # PAT for the loc AzDO instance https://dev.azure.com/ceapex

eng/common/templates/job/publish-build-assets.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ parameters:
1313
# Optional: Include PublishBuildArtifacts task
1414
enablePublishBuildArtifacts: false
1515

16-
# Optional: A defined YAML pool - https://docs.microsoft.com/en-us/azure/devops/pipelines/yaml-schema?view=vsts&tabs=schema#pool
16+
# Optional: A defined YAML pool - https://learn.microsoft.com/azure/devops/pipelines/yaml-schema?view=vsts&tabs=schema#pool
1717
pool: {}
1818

1919
# Optional: should run as a public build even in the internal project

eng/common/templates/jobs/codeql-build.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
parameters:
22
# See schema documentation in /Documentation/AzureDevOps/TemplateSchema.md
33
continueOnError: false
4-
# Required: A collection of jobs to run - https://docs.microsoft.com/en-us/azure/devops/pipelines/yaml-schema?view=vsts&tabs=schema#job
4+
# Required: A collection of jobs to run - https://learn.microsoft.com/azure/devops/pipelines/yaml-schema?view=vsts&tabs=schema#job
55
jobs: []
66
# Optional: if specified, restore and use this version of Guardian instead of the default.
77
overrideGuardianVersion: ''

0 commit comments

Comments
 (0)