Approach for referencing conceptual docs

src/EFCore/ChangeTracking/ArrayStructuralComparer.cs

@@ -11,6 +11,9 @@ namespace Microsoft.EntityFrameworkCore.ChangeTracking
     ///         A new array is constructed when snapshotting.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     For more information, see <see href="https://aka.ms/efcore-docs-value-comparers">EF Core value comparers</see>.
+    /// </remarks>
     /// <typeparam name="TElement"> The array element type. </typeparam>
     public class ArrayStructuralComparer<TElement> : ValueComparer<TElement[]>
     {

src/EFCore/ChangeTracking/CascadeTiming.cs

@@ -7,6 +7,9 @@ namespace Microsoft.EntityFrameworkCore.ChangeTracking
     ///     Defines different strategies for when cascading actions will be performed.
     ///     See <see cref="ChangeTracker.CascadeDeleteTiming" /> and <see cref="ChangeTracker.DeleteOrphansTiming" />.
     /// </summary>
+    /// <remarks>
+    ///     For more information, see <see href="https://aka.ms/efcore-docs-cascading">EF Core cascade deletes and deleting orphans</see>.
+    /// </remarks>
     public enum CascadeTiming
     {
         /// <summary>

src/EFCore/ChangeTracking/ChangeTracker.cs

@@ -20,6 +20,9 @@ namespace Microsoft.EntityFrameworkCore.ChangeTracking
     ///     Instances of this class are typically obtained from <see cref="DbContext.ChangeTracker" /> and it is not designed
     ///     to be directly constructed in your application code.
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-change-tracking">EF Core change tracking</see>.
+    /// </remarks>
     public class ChangeTracker : IResettableService
     {
         private readonly IRuntimeModel _model;

src/EFCore/ChangeTracking/ChangeTrackerDebugStringOptions.cs

@@ -8,6 +8,10 @@ namespace Microsoft.EntityFrameworkCore.ChangeTracking
     /// <summary>
     ///     Debug string customization options for tracked entities.
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-change-tracking">EF Core change tracking</see> and
+    ///     <see href="https://aka.ms/efcore-docs-debug-views">EF Core debug views</see>.
+    /// </remarks>
     [Flags]
     public enum ChangeTrackerDebugStringOptions
     {

src/EFCore/ChangeTracking/ChangeTrackerExtensions.cs

@@ -16,6 +16,9 @@ namespace Microsoft.EntityFrameworkCore
     /// <summary>
     ///     Extension methods for <see cref="ChangeTracker" />.
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-change-tracking">EF Core change tracking</see>.
+    /// </remarks>
     public static class ChangeTrackerExtensions
     {
         /// <summary>

src/EFCore/ChangeTracking/CollectionEntry.cs

@@ -24,6 +24,9 @@ namespace Microsoft.EntityFrameworkCore.ChangeTracking
     ///         not designed to be directly constructed in your application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-entity-entries">Accessing tracked entities in EF Core</see>.
+    /// </remarks>
     public class CollectionEntry : NavigationEntry
     {
         private ICollectionLoader? _loader;

src/EFCore/ChangeTracking/CollectionEntry`.cs

@@ -19,6 +19,9 @@ namespace Microsoft.EntityFrameworkCore.ChangeTracking
     ///         not designed to be directly constructed in your application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-entity-entries">Accessing tracked entities in EF Core</see>.
+    /// </remarks>
     /// <typeparam name="TEntity"> The type of the entity the property belongs to. </typeparam>
     /// <typeparam name="TRelatedEntity"> The type of the property. </typeparam>
     public class CollectionEntry<TEntity, TRelatedEntity> : CollectionEntry

src/EFCore/ChangeTracking/EntityEntry.cs

@@ -28,6 +28,9 @@ namespace Microsoft.EntityFrameworkCore.ChangeTracking
     ///         not designed to be directly constructed in your application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-entity-entries">Accessing tracked entities in EF Core</see>.
+    /// </remarks>
     [DebuggerDisplay("{" + nameof(InternalEntry) + ",nq}")]
     public class EntityEntry : IInfrastructure<InternalEntityEntry>
     {

src/EFCore/ChangeTracking/EntityEntryEventArgs.cs

@@ -10,6 +10,9 @@ namespace Microsoft.EntityFrameworkCore.ChangeTracking
     /// <summary>
     ///     Event arguments for events relating to tracked <see cref="EntityEntry" />s.
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-entity-entries">Accessing tracked entities in EF Core</see>.
+    /// </remarks>
     public class EntityEntryEventArgs : EventArgs
     {
         private readonly InternalEntityEntry _internalEntityEntry;

src/EFCore/ChangeTracking/EntityEntryGraphNode.cs

@@ -19,6 +19,9 @@ namespace Microsoft.EntityFrameworkCore.ChangeTracking
     ///         See <see cref="M:ChangeTracker.TrackGraph" /> for information on how graph nodes are used.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-track-graph">Tracking entities in EF Core</see>.
+    /// </remarks>
     public class EntityEntryGraphNode : IInfrastructure<InternalEntityEntry>
     {
         private readonly InternalEntityEntry _entry;

src/EFCore/ChangeTracking/EntityEntryGraphNode`.cs

@@ -13,6 +13,9 @@ namespace Microsoft.EntityFrameworkCore.ChangeTracking
     ///     Provides access to change tracking information and operations for a node in a
     ///     graph of entities that is being traversed.
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-track-graph">Tracking entities in EF Core</see>.
+    /// </remarks>
     public class EntityEntryGraphNode<TState> : EntityEntryGraphNode
     {
         /// <summary>

src/EFCore/ChangeTracking/EntityEntry`.cs

@@ -22,6 +22,9 @@ namespace Microsoft.EntityFrameworkCore.ChangeTracking
     ///         not designed to be directly constructed in your application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-entity-entries">Accessing tracked entities in EF Core</see>.
+    /// </remarks>
     /// <typeparam name="TEntity"> The type of entity being tracked by this entry. </typeparam>
     public class EntityEntry<TEntity> : EntityEntry
         where TEntity : class

src/EFCore/ChangeTracking/EntityStateChangedEventArgs.cs

@@ -9,6 +9,9 @@ namespace Microsoft.EntityFrameworkCore.ChangeTracking
     /// <summary>
     ///     Event arguments for the <see cref="ChangeTracker.StateChanged" /> event.
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-state-changes">State changes of entities in EF Core</see>.
+    /// </remarks>
     public class EntityStateChangedEventArgs : EntityEntryEventArgs
     {
         /// <summary>

src/EFCore/ChangeTracking/EntityTrackedEventArgs.cs

@@ -9,6 +9,9 @@ namespace Microsoft.EntityFrameworkCore.ChangeTracking
     /// <summary>
     ///     Event arguments for the <see cref="ChangeTracker.Tracked" /> event.
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-state-changes">State changes of entities in EF Core</see>.
+    /// </remarks>
     public class EntityTrackedEventArgs : EntityEntryEventArgs
     {
         /// <summary>

src/EFCore/ChangeTracking/EntryCurrentValueComparer`.cs

@@ -18,6 +18,9 @@ namespace Microsoft.EntityFrameworkCore.ChangeTracking
     ///         not used in application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     For more information, see <see href="https://aka.ms/efcore-docs-value-comparers">EF Core value comparers</see>.
+    /// </remarks>
     /// <typeparam name="TProperty"> The type of the property. </typeparam>
     public sealed class EntryCurrentValueComparer<TProperty> : IComparer<IUpdateEntry>, IEqualityComparer<IUpdateEntry>
     {

src/EFCore/ChangeTracking/GeometryValueComparer.cs

@@ -3,13 +3,15 @@
 
 using System;
 using System.Linq.Expressions;
-using System.Reflection;
 
 namespace Microsoft.EntityFrameworkCore.ChangeTracking
 {
     /// <summary>
     ///     Value snapshotting and comparison logic for NetTopologySuite.Geometries.Geometry instances.
     /// </summary>
+    /// <remarks>
+    ///     For more information, see <see href="https://aka.ms/efcore-docs-value-comparers">EF Core value comparers</see>.
+    /// </remarks>
     public class GeometryValueComparer<TGeometry> : ValueComparer<TGeometry>
     {
         /// <summary>

src/EFCore/ChangeTracking/IDependentKeyValueFactory.cs

@@ -18,6 +18,9 @@ namespace Microsoft.EntityFrameworkCore.ChangeTracking
     ///         not used in application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-providers">EF Core database providers</see>.
+    /// </remarks>
     /// <typeparam name="TKey"> The generic type of the key. </typeparam>
     public interface IDependentKeyValueFactory<TKey>
     {

src/EFCore/ChangeTracking/IEntityEntryGraphIterator.cs

@@ -18,6 +18,9 @@ namespace Microsoft.EntityFrameworkCore.ChangeTracking
     ///         This service cannot depend on services registered as <see cref="ServiceLifetime.Scoped" />.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-track-graph">Tracking entities in EF Core</see>.
+    /// </remarks>
     public interface IEntityEntryGraphIterator
     {
         /// <summary>

src/EFCore/ChangeTracking/IPrincipalKeyValueFactory.cs

@@ -17,6 +17,9 @@ namespace Microsoft.EntityFrameworkCore.ChangeTracking
     ///         not used in application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-providers">EF Core database providers</see>.
+    /// </remarks>
     /// <typeparam name="TKey"> The key type. </typeparam>
     public interface IPrincipalKeyValueFactory<TKey>
     {

src/EFCore/ChangeTracking/LocalView.cs

@@ -46,6 +46,9 @@ namespace Microsoft.EntityFrameworkCore.ChangeTracking
     ///         for WPF binding, or <see cref="ToBindingList" /> for WinForms.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-local-views">Local views of tracked entities in EF Core</see>.
+    /// </remarks>
     /// <typeparam name="TEntity">The type of the entity in the local view.</typeparam>
     public class LocalView<TEntity> :
         ICollection<TEntity>,

src/EFCore/ChangeTracking/MemberEntry.cs

@@ -24,6 +24,9 @@ namespace Microsoft.EntityFrameworkCore.ChangeTracking
     ///         not designed to be directly constructed in your application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-entity-entries">Accessing tracked entities in EF Core</see>.
+    /// </remarks>
     public abstract class MemberEntry : IInfrastructure<InternalEntityEntry>
     {
         /// <summary>

src/EFCore/ChangeTracking/NavigationEntry.cs

@@ -23,6 +23,9 @@ namespace Microsoft.EntityFrameworkCore.ChangeTracking
     ///         not designed to be directly constructed in your application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-entity-entries">Accessing tracked entities in EF Core</see>.
+    /// </remarks>
     public abstract class NavigationEntry : MemberEntry
     {
         /// <summary>

src/EFCore/ChangeTracking/ObservableHashSet.cs

@@ -14,6 +14,9 @@ namespace Microsoft.EntityFrameworkCore.ChangeTracking
     ///     A hash set that implements the interfaces required for Entity Framework to use notification based change tracking
     ///     for a collection navigation property.
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-local-views">Local views of tracked entities in EF Core</see>.
+    /// </remarks>
     /// <typeparam name="T"> The type of elements in the hash set. </typeparam>
     public class ObservableHashSet<T>
         : ISet<T>, IReadOnlyCollection<T>, INotifyCollectionChanged, INotifyPropertyChanged, INotifyPropertyChanging

src/EFCore/ChangeTracking/PropertyEntry.cs

@@ -16,6 +16,9 @@ namespace Microsoft.EntityFrameworkCore.ChangeTracking
     ///         not designed to be directly constructed in your application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-entity-entries">Accessing tracked entities in EF Core</see>.
+    /// </remarks>
     public class PropertyEntry : MemberEntry
     {
         /// <summary>

src/EFCore/ChangeTracking/PropertyEntry`.cs

@@ -16,6 +16,9 @@ namespace Microsoft.EntityFrameworkCore.ChangeTracking
     ///         not designed to be directly constructed in your application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-entity-entries">Accessing tracked entities in EF Core</see>.
+    /// </remarks>
     /// <typeparam name="TEntity"> The type of the entity the property belongs to. </typeparam>
     /// <typeparam name="TProperty"> The type of the property. </typeparam>
     public class PropertyEntry<TEntity, TProperty> : PropertyEntry

src/EFCore/ChangeTracking/PropertyValues.cs

@@ -24,6 +24,9 @@ namespace Microsoft.EntityFrameworkCore.ChangeTracking
     ///         concurrency exceptions signaled by the throwing of a <see cref="DbUpdateConcurrencyException" />.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-entity-entries">Accessing tracked entities in EF Core</see>.
+    /// </remarks>
     public abstract class PropertyValues
     {
         /// <summary>

src/EFCore/ChangeTracking/ReferenceEntry.cs

@@ -24,6 +24,9 @@ namespace Microsoft.EntityFrameworkCore.ChangeTracking
     ///         not designed to be directly constructed in your application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-entity-entries">Accessing tracked entities in EF Core</see>.
+    /// </remarks>
     public class ReferenceEntry : NavigationEntry
     {
         private IEntityFinder? _finder;

src/EFCore/ChangeTracking/ReferenceEntry`.cs

@@ -18,6 +18,9 @@ namespace Microsoft.EntityFrameworkCore.ChangeTracking
     ///         not designed to be directly constructed in your application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-entity-entries">Accessing tracked entities in EF Core</see>.
+    /// </remarks>
     /// <typeparam name="TEntity"> The type of the entity the property belongs to. </typeparam>
     /// <typeparam name="TProperty"> The type of the property. </typeparam>
     public class ReferenceEntry<TEntity, TProperty> : ReferenceEntry

src/EFCore/ChangeTracking/ValueComparer.cs

@@ -26,6 +26,9 @@ namespace Microsoft.EntityFrameworkCore.ChangeTracking
     ///         reference.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     For more information, see <see href="https://aka.ms/efcore-docs-value-comparers">EF Core value comparers</see>.
+    /// </remarks>
     public abstract class ValueComparer : IEqualityComparer, IEqualityComparer<object>
     {
         private static readonly MethodInfo _doubleEqualsMethodInfo

src/EFCore/ChangeTracking/ValueComparerExtensions.cs

@@ -6,6 +6,9 @@ namespace Microsoft.EntityFrameworkCore.ChangeTracking
     /// <summary>
     ///     Extension methods for <see cref="ValueComparer" />.
     /// </summary>
+    /// <remarks>
+    ///     For more information, see <see href="https://aka.ms/efcore-docs-value-comparers">EF Core value comparers</see>.
+    /// </remarks>
     public static class ValueComparerExtensions
     {
         /// <summary>

src/EFCore/ChangeTracking/ValueComparer`.cs

@@ -25,6 +25,9 @@ namespace Microsoft.EntityFrameworkCore.ChangeTracking
     ///         reference.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     For more information, see <see href="https://aka.ms/efcore-docs-value-comparers">EF Core value comparers</see>.
+    /// </remarks>
     /// <typeparam name="T"> The type. </typeparam>
     public class ValueComparer<T> : ValueComparer, IEqualityComparer<T>
     {

test/EFCore.Specification.Tests/Query/NorthwindGroupByQueryTestBase.cs

@@ -2,6 +2,7 @@
 // The .NET Foundation licenses this file to you under the MIT license.
 
 using System;
+using System.Collections.Generic;
 using System.Linq;
 using System.Threading.Tasks;
 using Microsoft.EntityFrameworkCore.TestModels.Northwind;