Skip to content

Replace more redirected /dotnet URLs#12549

Open
gewarren wants to merge 5 commits intodotnet:mainfrom
gewarren:non-desktop-urls
Open

Replace more redirected /dotnet URLs#12549
gewarren wants to merge 5 commits intodotnet:mainfrom
gewarren:non-desktop-urls

Conversation

@gewarren
Copy link
Copy Markdown
Contributor

Prep for #10722.

gewarren and others added 4 commits April 23, 2026 15:39
- /dotnet/framework/interop/com-callable-wrapper -> /dotnet/standard/native-interop/com-callable-wrapper
- /dotnet/framework/interop/runtime-callable-wrapper -> /dotnet/standard/native-interop/runtime-callable-wrapper
- /dotnet/framework/misc/using-the-assert-method -> /previous-versions/dotnet/framework/code-access-security/using-the-assert-method

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Update links across core, standard, framework, fundamentals, and csharp
categories to their current redirect destinations. Key changes:

- C# keywords/operators moved to new language-reference paths
- C# LINQ docs moved from programming-guide to linq/
- Framework link-demands and assert moved to previous-versions
- Framework interop docs moved to standard/native-interop
- Standard parallel-linq-plinq renamed to introduction-to-plinq
- Standard threading/ redirects to threading/managed-threading-basics
- Fundamentals apicompat and networking path updates

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions github-actions Bot added the area-Meta Concerns something that extends across runtime area boundaries, for example, IDisposable. label Apr 24, 2026
@gewarren gewarren marked this pull request as ready for review April 24, 2026 04:17
Copilot AI review requested due to automatic review settings April 24, 2026 04:17
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates .NET API reference documentation to replace redirected /dotnet/... links with newer target URLs, as preparation for #10722’s broader reconciliation work.

Changes:

  • Updates many <related> and inline documentation links to newer Learn URL paths (C#, threading, reflection, PLINQ, interop, etc.).
  • Replaces “supplemental remarks” links with inlined markdown remarks for some LINQ-to-SQL types.
  • Adds new snippet projects/files for System.Data.Linq.TableAttribute (C# and Visual Basic).

Reviewed changes

Copilot reviewed 128 out of 129 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
xml/System/UIntPtr.xml Updates C# nuint documentation link.
xml/System/Type.xml Updates reflection article links.
xml/System/ThreadStaticAttribute.xml Updates threading article link.
xml/System/String.xml Updates foreach documentation link.
xml/System/Span`1+Enumerator.xml Updates foreach and ref struct documentation links.
xml/System/ReadOnlySpan`1+Enumerator.xml Updates foreach documentation link.
xml/System/Nullable`1.xml Updates default documentation link.
xml/System/NullReferenceException.xml Updates operator and nullable-reference-types links.
xml/System/MathF.xml Updates remainder operator documentation link.
xml/System/Math.xml Updates remainder operator documentation links.
xml/System/IntPtr.xml Updates C# nint documentation link.
xml/System/IndexOutOfRangeException.xml Updates foreach documentation link.
xml/System/Func`5.xml Updates anonymous method / lambda expression links.
xml/System/Func`4.xml Updates anonymous method / lambda expression links.
xml/System/Func`3.xml Updates anonymous method / lambda expression links.
xml/System/Func`2.xml Updates anonymous method / lambda expression links.
xml/System/Func`1.xml Updates anonymous method / lambda expression links.
xml/System/DuplicateWaitObjectException.xml Updates threading article link.
xml/System/ArraySegment`1+Enumerator.xml Updates foreach documentation link.
xml/System/ArgumentOutOfRangeException.xml Updates threading + lock statement documentation links.
xml/System/AppDomainManager.xml Adjusts IMPORTANT/NOTE formatting and removes Link Demands link.
xml/System/AggregateException.xml Updates PLINQ article link.
xml/System/Action`4.xml Updates anonymous method / lambda expression links.
xml/System/Action`3.xml Updates anonymous method / lambda expression links.
xml/System/Action`2.xml Updates anonymous method / lambda expression links.
xml/System/Action`1.xml Updates anonymous method / lambda expression links.
xml/System/Action.xml Updates anonymous method / lambda expression links.
xml/System.Xml/XmlWriterSettings.xml Updates async programming article link.
xml/System.Xml/XmlResolver.xml Updates async programming article link.
xml/System.Xml/XmlReaderSettings.xml Updates async programming article link.
xml/System.Xml/XmlReader.xml Updates async programming article links.
xml/System.Xml/XmlDictionaryWriter.xml Updates async programming article links.
xml/System.Xml.Xsl/XsltArgumentList.xml Updates params documentation link.
xml/System.Xml.Xsl/XslTransform.xml Updates params documentation link.
xml/System.Xml.Linq/XElement.xml Updates XElement overview links (standard LINQ).
xml/System.Windows.Shell/JumpList.xml Updates Link Demands link to previous-versions URL.
xml/System.Windows.Input/TouchDevice.xml Updates Link Demands link to previous-versions URL.
xml/System.Windows.Controls/ItemContainerGenerator.xml Updates using statement article link.
xml/System.Windows.Annotations.Storage/AnnotationStore.xml Updates lock statement article link.
xml/System.Threading/WaitHandle.xml Updates threading-related article links.
xml/System.Threading/Semaphore.xml Updates threading-related article links.
xml/System.Threading/ReaderWriterLock.xml Updates threading-related article links.
xml/System.Threading/Mutex.xml Updates threading-related article links.
xml/System.Threading/Monitor.xml Updates threading-related article links.
xml/System.Threading/ManualResetEvent.xml Updates synchronization primitives article links.
xml/System.Threading/LockCookie.xml Updates reader-writer locks article links.
xml/System.Threading/Interlocked.xml Updates synchronization primitives article links.
xml/System.Threading/EventWaitHandle.xml Updates synchronization primitives article links.
xml/System.Threading/AutoResetEvent.xml Updates synchronization primitives article links.
xml/System.Security/SecurityException.xml Updates C# is operator documentation links.
xml/System.Security.Permissions/SecurityAction.xml Removes framework-specific Assert Method link from summary.
xml/System.Security.Permissions/HostProtectionAttribute.xml Removes Link Demands related link.
xml/System.Security.Cryptography/CryptoStream.xml Updates async programming article links.
xml/System.Runtime.Versioning/RequiresPreviewFeaturesAttribute.xml Updates Preview APIs article link.
xml/System.Runtime.Serialization/FormatterServices.xml Removes Link Demands link from remarks text.
xml/System.Runtime.Remoting/SoapServices.xml Removes Link Demands link and extra blank lines.
xml/System.Runtime.Remoting/ObjRef.xml Removes Link Demands link.
xml/System.Runtime.Remoting.Services/TrackingServices.xml Normalizes markdown formatting and removes Link Demands link.
xml/System.Runtime.Remoting.Services/ITrackingHandler.xml Normalizes markdown formatting and removes Link Demands link.
xml/System.Runtime.Remoting.Services/EnterpriseServicesHelper.xml Updates COM callable wrapper link and edits Link Demands note text.
xml/System.Runtime.Remoting.Proxies/RealProxy.xml Removes Link Demands link and updates COM callable wrapper link.
xml/System.Runtime.Remoting.Proxies/ProxyAttribute.xml Removes Link Demands link.
xml/System.Runtime.Remoting.Messaging/ReturnMessage.xml Removes Link Demands link.
xml/System.Runtime.Remoting.Messaging/RemotingSurrogateSelector.xml Removes Link Demands link.
xml/System.Runtime.Remoting.Messaging/LogicalCallContext.xml Removes Link Demands link and extra blank lines.
xml/System.Runtime.Remoting.Messaging/CallContext.xml Removes Link Demands link and extra blank lines.
xml/System.Runtime.Remoting.Lifetime/LifetimeServices.xml Removes Link Demands link and extra blank lines.
xml/System.Runtime.Remoting.Lifetime/ClientSponsor.xml Removes Link Demands link.
xml/System.Runtime.Remoting.Contexts/SynchronizationAttribute.xml Removes Link Demands link.
xml/System.Runtime.Remoting.Channels/TransportHeaders.xml Removes Link Demands link.
xml/System.Runtime.Remoting.Channels/ServerChannelSinkStack.xml Removes Link Demands link.
xml/System.Runtime.Remoting.Channels/ClientChannelSinkStack.xml Removes Link Demands link.
xml/System.Runtime.Remoting.Channels/ChannelDataStore.xml Removes Link Demands link.
xml/System.Runtime.Remoting.Channels/BaseChannelWithProperties.xml Removes Link Demands link.
xml/System.Runtime.Remoting.Channels/BaseChannelSinkWithProperties.xml Removes Link Demands link.
xml/System.Runtime.Remoting.Channels/BaseChannelObjectWithProperties.xml Removes Link Demands link.
xml/System.Runtime.InteropServices/Marshal.xml Updates COM callable/runtime callable wrapper links to standard interop docs.
xml/System.Runtime.CompilerServices/AsyncStateMachineAttribute.xml Updates async + typeof links.
xml/System.Reflection/MethodInfo.xml Updates generics article link.
xml/System.Reflection/MethodImplAttributes.xml Updates lock statement link.
xml/System.Reflection/AssemblyName.xml Updates reflection article links.
xml/System.Reflection/Assembly.xml Updates reflection article link.
xml/System.Net.Http/HttpClient.xml Updates HttpClient guidelines article link.
xml/System.Linq/ParallelQuery`1.xml Updates PLINQ article link.
xml/System.Linq/ParallelQuery.xml Updates PLINQ article link.
xml/System.Linq/ParallelMergeOptions.xml Updates PLINQ article link.
xml/System.Linq/ParallelExecutionMode.xml Updates PLINQ article link.
xml/System.Linq/OrderedParallelQuery`1.xml Updates PLINQ article link.
xml/System.Linq/Enumerable.xml Updates many LINQ programming guide links to newer LINQ docs.
xml/System.Linq.Expressions/Expression`1.xml Updates lambda expressions article link.
xml/System.IO/File.xml Updates LINQ-to-Objects link.
xml/System.Dynamic/DynamicObject.xml Updates dynamic keyword article link.
xml/System.Diagnostics/ProcessStartInfo.xml Removes Link Demands link.
xml/System.Diagnostics/Process.xml Removes Link Demands link.
xml/System.Diagnostics/FileVersionInfo.xml Removes Link Demands link and extra blank lines.
xml/System.Diagnostics/Debug.xml Updates params keyword link.
xml/System.Diagnostics.Tracing/EventSource.xml Updates /unsafe compiler option link.
xml/System.Diagnostics.CodeAnalysis/ExperimentalAttribute.xml Updates Preview APIs article link.
xml/System.Data/TypedTableBaseExtensions.xml Updates standard query operators article link.
xml/System.Data/EnumerableRowCollectionExtensions.xml Updates standard query operators article link.
xml/System.Data.Linq/DataLoadOptions.xml Replaces supplemental link with inlined markdown remarks.
xml/System.Data.Linq.Mapping/TableAttribute.xml Replaces supplemental link with inlined markdown remarks and adds snippet references.
xml/System.Collections/DictionaryEntry.xml Updates foreach documentation link.
xml/System.Collections/DictionaryBase.xml Updates foreach documentation link.
xml/System.Collections.Generic/IEnumerable`1.xml Updates yield keyword documentation link.
xml/System.CodeDom/CodeTypeParameter.xml Updates generics article link.
xml/System.CodeDom/CodeTypeDeclaration.xml Updates generics article link.
xml/System.CodeDom/CodeDefaultValueExpression.xml Updates generics article link.
xml/System.CodeDom.Compiler/TempFileCollection.xml Removes Link Demands link.
xml/System.CodeDom.Compiler/IndentedTextWriter.xml Removes Link Demands link.
xml/System.CodeDom.Compiler/Executor.xml Normalizes markdown formatting and removes Link Demands link.
xml/System.CodeDom.Compiler/CompilerParameters.xml Removes Link Demands link.
xml/System.CodeDom.Compiler/CompilerInfo.xml Removes Link Demands link and extra blank lines.
xml/System.CodeDom.Compiler/CodeParser.xml Removes Link Demands link.
xml/System.CodeDom.Compiler/CodeGeneratorOptions.xml Removes Link Demands link.
xml/System.CodeDom.Compiler/CodeGenerator.xml Removes Link Demands link.
xml/System.CodeDom.Compiler/CodeDomProvider.xml Removes Link Demands link.
xml/System.CodeDom.Compiler/CodeCompiler.xml Removes Link Demands link.
xml/System.AddIn.Contract.Automation/RemoteParameterData.xml Updates params documentation link.
xml/Microsoft.CSharp/Compiler.xml Updates many compiler-option links to newer compiler-options pages.
xml/Microsoft.CSharp/CSharpCodeProvider.xml Updates reflection article link.
snippets/visualbasic/System.Data.Linq/TableAttribute/Overview/Project.vbproj Adds VB snippet project for TableAttribute.
snippets/visualbasic/System.Data.Linq/TableAttribute/Overview/Module1.vb Adds VB snippet source with snippet regions.
snippets/csharp/System.Data.Linq/TableAttribute/Overview/Project.csproj Adds C# snippet project for TableAttribute.
snippets/csharp/System.Data.Linq/TableAttribute/Overview/Program.cs Adds C# snippet source with snippet regions.

Comment on lines 81 to 83
> [!NOTE]
> You can avoid most `NullReferenceException` exceptions in C# by using the [null-conditional operator](/dotnet/csharp/language-reference/operators/null-conditional-operator) (`?.`) or the [null-coalescing operator](/dotnet/csharp/language-reference/operators/null-coalescing-operator) (`??`). For more information, see [Nullable reference types](/dotnet/csharp/whats-new/csharp-8#nullable-reference-types). The following C# examples assume the nullable context is disabled (not recommended).
> You can avoid most `NullReferenceException` exceptions in C# by using the [null-conditional operator](/dotnet/csharp/language-reference/operators/null-coalescing-operator) (`?.`) or the [null-coalescing operator](/dotnet/csharp/language-reference/operators/null-coalescing-operator) (`??`). For more information, see [Nullable reference types](/dotnet/csharp/whats-new/csharp-version-history). The following C# examples assume the nullable context is disabled (not recommended).
Copy link

Copilot AI Apr 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The link for the null-conditional operator (?.) points to the null-coalescing operator article. This makes the guidance incorrect and sends readers to the wrong operator documentation. Update the href to the null-conditional operator page, and consider linking "Nullable reference types" to the nullable reference types section/page (not the general version history).

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area-Meta Concerns something that extends across runtime area boundaries, for example, IDisposable.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants