Finish linking to conceptual docs (#25983)

Fixes #17508
dotnet · Sep 14, 2021 · 753195e · 753195e
1 parent 0720568
commit 753195e
Show file tree

Hide file tree

Showing 338 changed files with 2,167 additions and 7 deletions.
diff --git a/src/EFCore.Design/Design/DesignTimeServiceCollectionExtensions.cs b/src/EFCore.Design/Design/DesignTimeServiceCollectionExtensions.cs
@@ -22,11 +22,17 @@ namespace Microsoft.EntityFrameworkCore.Design
     ///     Extension methods for adding Entity Framework Core design-time services to an
     ///     <see cref="IServiceCollection" />.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-design-time-services">EF Core design-time services</see> for more information.
+    /// </remarks>
     public static class DesignTimeServiceCollectionExtensions
     {
         /// <summary>
         ///     Adds the Entity Framework Core design-time services.
         /// </summary>
+        /// <remarks>
+        ///     See <see href="https://aka.ms/efcore-docs-design-time-services">EF Core design-time services</see> for more information.
+        /// </remarks>
         /// <param name="services"> The <see cref="IServiceCollection" /> the services will be added to. </param>
         /// <param name="reporter"> Used to report design-time messages. </param>
         /// <param name="applicationServiceProviderAccessor"> An accessor to the application service provider. </param>
@@ -80,6 +86,9 @@ public static IServiceCollection AddEntityFrameworkDesignTimeServices(
         /// <summary>
         ///     Adds services from the <see cref="DbContext" /> which are used at design time.
         /// </summary>
+        /// <remarks>
+        ///     See <see href="https://aka.ms/efcore-docs-design-time-services">EF Core design-time services</see> for more information.
+        /// </remarks>
         /// <param name="services"> The <see cref="IServiceCollection" /> the services will be added to. </param>
         /// <param name="context"> The <see cref="DbContext" /> the services will be added from. </param>
         /// <returns> The <paramref name="services" />. This enables chaining additional method calls. </returns>

diff --git a/src/EFCore.Design/Design/ILanguageBasedService.cs b/src/EFCore.Design/Design/ILanguageBasedService.cs
@@ -6,6 +6,9 @@ namespace Microsoft.EntityFrameworkCore.Design
     /// <summary>
     ///     Represents a service that gets resolved based on the programming language it supports.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-design-time-services">EF Core design-time services</see> for more information.
+    /// </remarks>
     public interface ILanguageBasedService
     {
         /// <summary>

diff --git a/src/EFCore.Design/Design/IPluralizer.cs b/src/EFCore.Design/Design/IPluralizer.cs
@@ -8,6 +8,9 @@ namespace Microsoft.EntityFrameworkCore.Design
     /// <summary>
     ///     Converts identifiers to the plural and singular equivalents.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-design-time-services">EF Core design-time services</see> for more information.
+    /// </remarks>
     public interface IPluralizer
     {
         /// <summary>

diff --git a/src/EFCore.Design/Migrations/Design/CSharpMigrationOperationGenerator.cs b/src/EFCore.Design/Migrations/Design/CSharpMigrationOperationGenerator.cs
@@ -15,6 +15,10 @@ namespace Microsoft.EntityFrameworkCore.Migrations.Design
     /// <summary>
     ///     Used to generate C# for creating <see cref="MigrationOperation" /> objects.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-migrations">Database migrations</see>, and
+    ///     <see href="https://aka.ms/efcore-docs-design-time-services">EF Core design-time services</see> for more information.
+    /// </remarks>
     public class CSharpMigrationOperationGenerator : ICSharpMigrationOperationGenerator
     {
         /// <summary>

diff --git a/src/EFCore.Design/Migrations/Design/CSharpMigrationsGenerator.cs b/src/EFCore.Design/Migrations/Design/CSharpMigrationsGenerator.cs
@@ -16,6 +16,10 @@ namespace Microsoft.EntityFrameworkCore.Migrations.Design
     /// <summary>
     ///     Used to generate C# code for migrations.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-migrations">Database migrations</see>, and
+    ///     <see href="https://aka.ms/efcore-docs-design-time-services">EF Core design-time services</see> for more information.
+    /// </remarks>
     public class CSharpMigrationsGenerator : MigrationsCodeGenerator
     {
         /// <summary>

diff --git a/src/EFCore.Design/Migrations/Design/CSharpSnapshotGenerator.cs b/src/EFCore.Design/Migrations/Design/CSharpSnapshotGenerator.cs
@@ -19,6 +19,10 @@ namespace Microsoft.EntityFrameworkCore.Migrations.Design
     /// <summary>
     ///     Used to generate C# code for creating an <see cref="IModel" />.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-migrations">Database migrations</see>, and
+    ///     <see href="https://aka.ms/efcore-docs-design-time-services">EF Core design-time services</see> for more information.
+    /// </remarks>
     public class CSharpSnapshotGenerator : ICSharpSnapshotGenerator
     {
         private static readonly MethodInfo _hasAnnotationMethodInfo

diff --git a/src/EFCore.Design/Migrations/Design/ICSharpMigrationOperationGenerator.cs b/src/EFCore.Design/Migrations/Design/ICSharpMigrationOperationGenerator.cs
@@ -10,6 +10,10 @@ namespace Microsoft.EntityFrameworkCore.Migrations.Design
     /// <summary>
     ///     Used to generate C# code for creating <see cref="MigrationOperation" /> objects.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-migrations">Database migrations</see>, and
+    ///     <see href="https://aka.ms/efcore-docs-design-time-services">EF Core design-time services</see> for more information.
+    /// </remarks>
     public interface ICSharpMigrationOperationGenerator
     {
         /// <summary>

diff --git a/src/EFCore.Design/Migrations/Design/ICSharpSnapshotGenerator.cs b/src/EFCore.Design/Migrations/Design/ICSharpSnapshotGenerator.cs
@@ -9,6 +9,10 @@ namespace Microsoft.EntityFrameworkCore.Migrations.Design
     /// <summary>
     ///     Used to generate C# code for creating an <see cref="IModel" />.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-migrations">Database migrations</see>, and
+    ///     <see href="https://aka.ms/efcore-docs-design-time-services">EF Core design-time services</see> for more information.
+    /// </remarks>
     public interface ICSharpSnapshotGenerator
     {
         /// <summary>

diff --git a/src/EFCore.Design/Migrations/Design/IMigrationsCodeGenerator.cs b/src/EFCore.Design/Migrations/Design/IMigrationsCodeGenerator.cs
@@ -12,6 +12,10 @@ namespace Microsoft.EntityFrameworkCore.Migrations.Design
     /// <summary>
     ///     Used to generate code for migrations.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-migrations">Database migrations</see>, and
+    ///     <see href="https://aka.ms/efcore-docs-design-time-services">EF Core design-time services</see> for more information.
+    /// </remarks>
     public interface IMigrationsCodeGenerator : ILanguageBasedService
     {
         /// <summary>

diff --git a/src/EFCore.Design/Migrations/Design/IMigrationsCodeGeneratorSelector.cs b/src/EFCore.Design/Migrations/Design/IMigrationsCodeGeneratorSelector.cs
@@ -6,6 +6,10 @@ namespace Microsoft.EntityFrameworkCore.Migrations.Design
     /// <summary>
     ///     Selects an <see cref="IMigrationsCodeGenerator" /> service for a given programming language.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-migrations">Database migrations</see>, and
+    ///     <see href="https://aka.ms/efcore-docs-design-time-services">EF Core design-time services</see> for more information.
+    /// </remarks>
     public interface IMigrationsCodeGeneratorSelector
     {
         /// <summary>

diff --git a/src/EFCore.Design/Migrations/Design/IMigrationsScaffolder.cs b/src/EFCore.Design/Migrations/Design/IMigrationsScaffolder.cs
@@ -6,6 +6,10 @@ namespace Microsoft.EntityFrameworkCore.Migrations.Design
     /// <summary>
     ///     Used to scaffold new migrations.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-migrations">Database migrations</see>, and
+    ///     <see href="https://aka.ms/efcore-docs-design-time-services">EF Core design-time services</see> for more information.
+    /// </remarks>
     public interface IMigrationsScaffolder
     {
         /// <summary>

diff --git a/src/EFCore.Design/Migrations/Design/MigrationsBundle.cs b/src/EFCore.Design/Migrations/Design/MigrationsBundle.cs
@@ -15,6 +15,9 @@ namespace Microsoft.EntityFrameworkCore.Migrations.Design
     /// <summary>
     ///     Defines the entry point for Migrations bundles.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-migration-bundles">EF Core migration bundles</see>.
+    /// </remarks>
     public static class MigrationsBundle
     {
         private static string? _context;

diff --git a/src/EFCore.Design/Migrations/Design/MigrationsCodeGenerator.cs b/src/EFCore.Design/Migrations/Design/MigrationsCodeGenerator.cs
@@ -15,6 +15,10 @@ namespace Microsoft.EntityFrameworkCore.Migrations.Design
     /// <summary>
     ///     Used to generate code for migrations.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-migrations">Database migrations</see>, and
+    ///     <see href="https://aka.ms/efcore-docs-design-time-services">EF Core design-time services</see> for more information.
+    /// </remarks>
     public abstract class MigrationsCodeGenerator : IMigrationsCodeGenerator
     {
         /// <summary>

diff --git a/src/EFCore.Design/Migrations/Design/MigrationsScaffolder.cs b/src/EFCore.Design/Migrations/Design/MigrationsScaffolder.cs
@@ -20,6 +20,10 @@ namespace Microsoft.EntityFrameworkCore.Migrations.Design
     /// <summary>
     ///     Used to scaffold new migrations.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-migrations">Database migrations</see>, and
+    ///     <see href="https://aka.ms/efcore-docs-design-time-services">EF Core design-time services</see> for more information.
+    /// </remarks>
     public class MigrationsScaffolder : IMigrationsScaffolder
     {
         private readonly Type _contextType;

diff --git a/src/EFCore.Design/Scaffolding/ICompiledModelCodeGenerator.cs b/src/EFCore.Design/Scaffolding/ICompiledModelCodeGenerator.cs
@@ -10,6 +10,10 @@ namespace Microsoft.EntityFrameworkCore.Scaffolding
     /// <summary>
     ///     Used to generate code for compiled model metadata.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-compiled-models">EF Core compiled models</see>, and
+    ///     <see href="https://aka.ms/efcore-docs-design-time-services">EF Core design-time services</see> for more information.
+    /// </remarks>
     public interface ICompiledModelCodeGenerator : ILanguageBasedService
     {
         /// <summary>

diff --git a/src/EFCore.Design/Scaffolding/ICompiledModelCodeGeneratorSelector.cs b/src/EFCore.Design/Scaffolding/ICompiledModelCodeGeneratorSelector.cs
@@ -6,6 +6,10 @@ namespace Microsoft.EntityFrameworkCore.Scaffolding
     /// <summary>
     ///     Selects an <see cref="ICompiledModelCodeGenerator" /> service for given generation options.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-compiled-models">EF Core compiled models</see>, and
+    ///     <see href="https://aka.ms/efcore-docs-design-time-services">EF Core design-time services</see> for more information.
+    /// </remarks>
     public interface ICompiledModelCodeGeneratorSelector
     {
         /// <summary>

diff --git a/src/EFCore.Design/Scaffolding/ICompiledModelScaffolder.cs b/src/EFCore.Design/Scaffolding/ICompiledModelScaffolder.cs
@@ -9,6 +9,10 @@ namespace Microsoft.EntityFrameworkCore.Scaffolding
     /// <summary>
     ///     Used to scaffold a compiled model from a model.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-compiled-models">EF Core compiled models</see>, and
+    ///     <see href="https://aka.ms/efcore-docs-design-time-services">EF Core design-time services</see> for more information.
+    /// </remarks>
     public interface ICompiledModelScaffolder
     {
         /// <summary>

diff --git a/src/EFCore.Design/Scaffolding/IModelCodeGenerator.cs b/src/EFCore.Design/Scaffolding/IModelCodeGenerator.cs
@@ -9,6 +9,9 @@ namespace Microsoft.EntityFrameworkCore.Scaffolding
     /// <summary>
     ///     Used to generate code for a model.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-design-time-services">EF Core design-time services</see> for more information.
+    /// </remarks>
     public interface IModelCodeGenerator : ILanguageBasedService
     {
         /// <summary>

diff --git a/src/EFCore.Design/Scaffolding/IModelCodeGeneratorSelector.cs b/src/EFCore.Design/Scaffolding/IModelCodeGeneratorSelector.cs
@@ -6,6 +6,9 @@ namespace Microsoft.EntityFrameworkCore.Scaffolding
     /// <summary>
     ///     Selects an <see cref="IModelCodeGenerator" /> service for a given programming language.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-design-time-services">EF Core design-time services</see> for more information.
+    /// </remarks>
     public interface IModelCodeGeneratorSelector
     {
         /// <summary>

diff --git a/src/EFCore.Design/Scaffolding/IReverseEngineerScaffolder.cs b/src/EFCore.Design/Scaffolding/IReverseEngineerScaffolder.cs
@@ -6,6 +6,10 @@ namespace Microsoft.EntityFrameworkCore.Scaffolding
     /// <summary>
     ///     Used to scaffold a model from a database schema.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-scaffolding">Reverse engineering (scaffolding) an existing database</see>, and
+    ///     <see href="https://aka.ms/efcore-docs-design-time-services">EF Core design-time services</see> for more information.
+    /// </remarks>
     public interface IReverseEngineerScaffolder
     {
         /// <summary>

diff --git a/src/EFCore.Design/Scaffolding/IScaffoldingModelFactory.cs b/src/EFCore.Design/Scaffolding/IScaffoldingModelFactory.cs
@@ -9,6 +9,10 @@ namespace Microsoft.EntityFrameworkCore.Scaffolding
     /// <summary>
     ///     Used to create an <see cref="IModel"/> from a <see cref="DatabaseModel"/>.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-scaffolding">Reverse engineering (scaffolding) an existing database</see>, and
+    ///     <see href="https://aka.ms/efcore-docs-design-time-services">EF Core design-time services</see> for more information.
+    /// </remarks>
     public interface IScaffoldingModelFactory
     {
         /// <summary>

diff --git a/src/EFCore.Design/Scaffolding/ModelCodeGenerator.cs b/src/EFCore.Design/Scaffolding/ModelCodeGenerator.cs
@@ -9,6 +9,9 @@ namespace Microsoft.EntityFrameworkCore.Scaffolding
     /// <summary>
     ///     Used to generate code for a model.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-design-time-services">EF Core design-time services</see> for more information.
+    /// </remarks>
     public abstract class ModelCodeGenerator : IModelCodeGenerator
     {
         /// <summary>

diff --git a/src/EFCore.Proxies/ProxiesExtensions.cs b/src/EFCore.Proxies/ProxiesExtensions.cs
@@ -26,6 +26,9 @@ public static class ProxiesExtensions
         ///         <see cref="ProxiesServiceCollectionExtensions.AddEntityFrameworkProxies" /> may be needed.
         ///     </para>
         /// </summary>
+        /// <remarks>
+        ///     See <see href="https://aka.ms/efcore-docs-notification-entities">Notification entities</see> for more information.
+        /// </remarks>
         /// <param name="optionsBuilder">
         ///     The options builder, as passed to <see cref="DbContext.OnConfiguring" />
         ///     or exposed AddDbContext.
@@ -66,6 +69,9 @@ public static DbContextOptionsBuilder UseChangeTrackingProxies(
         ///         <see cref="ProxiesServiceCollectionExtensions.AddEntityFrameworkProxies" /> may be needed.
         ///     </para>
         /// </summary>
+        /// <remarks>
+        ///     See <see href="https://aka.ms/efcore-docs-notification-entities">Notification entities</see> for more information.
+        /// </remarks>
         /// <typeparam name="TContext"> The <see cref="DbContext" /> type. </typeparam>
         /// <param name="optionsBuilder">
         ///     The options builder, as passed to <see cref="DbContext.OnConfiguring" />
@@ -98,6 +104,9 @@ public static DbContextOptionsBuilder<TContext> UseChangeTrackingProxies<TContex
         ///         <see cref="ProxiesServiceCollectionExtensions.AddEntityFrameworkProxies" /> may be needed.
         ///     </para>
         /// </summary>
+        /// <remarks>
+        ///     See <see href="https://aka.ms/efcore-docs-lazy-loading">Lazy loading</see> for more information.
+        /// </remarks>
         /// <param name="optionsBuilder">
         ///     The options builder, as passed to <see cref="DbContext.OnConfiguring" />
         ///     or exposed AddDbContext.
@@ -130,6 +139,9 @@ public static DbContextOptionsBuilder UseLazyLoadingProxies(
         ///         <see cref="ProxiesServiceCollectionExtensions.AddEntityFrameworkProxies" /> may be needed.
         ///     </para>
         /// </summary>
+        /// <remarks>
+        ///     See <see href="https://aka.ms/efcore-docs-lazy-loading">Lazy loading</see> for more information.
+        /// </remarks>
         /// <typeparam name="TContext"> The <see cref="DbContext" /> type. </typeparam>
         /// <param name="optionsBuilder">
         ///     The options builder, as passed to <see cref="DbContext.OnConfiguring" />

diff --git a/src/EFCore.Relational/Design/AnnotationCodeGenerator.cs b/src/EFCore.Relational/Design/AnnotationCodeGenerator.cs
@@ -27,6 +27,10 @@ namespace Microsoft.EntityFrameworkCore.Design
     ///         annotations that they understand.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-providers">Implementation of database providers and extensions</see>
+    ///     for more information.
+    /// </remarks>
     public class AnnotationCodeGenerator : IAnnotationCodeGenerator
     {
         private static readonly ISet<string> _ignoredRelationalAnnotations = new HashSet<string>

diff --git a/src/EFCore.Relational/Design/EntityFrameworkRelationalDesignServicesBuilder.cs b/src/EFCore.Relational/Design/EntityFrameworkRelationalDesignServicesBuilder.cs
@@ -25,6 +25,10 @@ namespace Microsoft.EntityFrameworkCore.Design
     ///         can handle the new scope, and that it does not cause issue for services that depend on it.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-providers">Implementation of database providers and extensions</see>
+    ///     for more information.
+    /// </remarks>
     public class EntityFrameworkRelationalDesignServicesBuilder : EntityFrameworkDesignServicesBuilder
     {
         /// <summary>

diff --git a/src/EFCore.Relational/Design/IAnnotationCodeGenerator.cs b/src/EFCore.Relational/Design/IAnnotationCodeGenerator.cs
@@ -14,6 +14,10 @@ namespace Microsoft.EntityFrameworkCore.Design
     ///     have code generated (as opposed to being handled by convention) and then to generate
     ///     the code if needed.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-providers">Implementation of database providers and extensions</see>
+    ///     for more information.
+    /// </remarks>
     public interface IAnnotationCodeGenerator
     {
         /// <summary>

diff --git a/src/EFCore.Relational/Diagnostics/BatchEventData.cs b/src/EFCore.Relational/Diagnostics/BatchEventData.cs
@@ -12,6 +12,9 @@ namespace Microsoft.EntityFrameworkCore.Diagnostics
     ///     The <see cref="DiagnosticSource" /> event payload for
     ///     <see cref="RelationalEventId" /> batch events.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-diagnostics">Logging, events, and diagnostics</see> for more information.
+    /// </remarks>
     public class BatchEventData : EventData
     {
         /// <summary>

diff --git a/src/EFCore.Relational/Diagnostics/CommandCorrelatedEventData.cs b/src/EFCore.Relational/Diagnostics/CommandCorrelatedEventData.cs
@@ -10,6 +10,9 @@ namespace Microsoft.EntityFrameworkCore.Diagnostics
     /// <summary>
     ///     The <see cref="DiagnosticSource" /> event payload for events correlated with a <see cref="DbCommand" />.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-diagnostics">Logging, events, and diagnostics</see> for more information.
+    /// </remarks>
     public class CommandCorrelatedEventData : DbContextEventData
     {
         /// <summary>

diff --git a/src/EFCore.Relational/Diagnostics/CommandEndEventData.cs b/src/EFCore.Relational/Diagnostics/CommandEndEventData.cs
@@ -11,6 +11,9 @@ namespace Microsoft.EntityFrameworkCore.Diagnostics
     ///     The <see cref="DiagnosticSource" /> event payload for
     ///     <see cref="RelationalEventId" /> command end events.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-diagnostics">Logging, events, and diagnostics</see> for more information.
+    /// </remarks>
     public class CommandEndEventData : CommandEventData
     {
         /// <summary>

diff --git a/src/EFCore.Relational/Diagnostics/CommandErrorEventData.cs b/src/EFCore.Relational/Diagnostics/CommandErrorEventData.cs
@@ -10,6 +10,9 @@ namespace Microsoft.EntityFrameworkCore.Diagnostics
     /// <summary>
     ///     The <see cref="DiagnosticSource" /> event payload for <see cref="RelationalEventId.CommandError" />.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-diagnostics">Logging, events, and diagnostics</see> for more information.
+    /// </remarks>
     public class CommandErrorEventData : CommandEndEventData, IErrorEventData
     {
         /// <summary>

diff --git a/src/EFCore.Relational/Diagnostics/CommandEventData.cs b/src/EFCore.Relational/Diagnostics/CommandEventData.cs
@@ -11,6 +11,9 @@ namespace Microsoft.EntityFrameworkCore.Diagnostics
     ///     The <see cref="DiagnosticSource" /> event payload for
     ///     <see cref="RelationalEventId" /> command events.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-diagnostics">Logging, events, and diagnostics</see> for more information.
+    /// </remarks>
     public class CommandEventData : CommandCorrelatedEventData
     {
         /// <summary>

diff --git a/src/EFCore.Relational/Diagnostics/CommandExecutedEventData.cs b/src/EFCore.Relational/Diagnostics/CommandExecutedEventData.cs
@@ -10,6 +10,9 @@ namespace Microsoft.EntityFrameworkCore.Diagnostics
     /// <summary>
     ///     The <see cref="DiagnosticSource" /> event payload for <see cref="RelationalEventId.CommandExecuted" />.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-diagnostics">Logging, events, and diagnostics</see> for more information.
+    /// </remarks>
     public class CommandExecutedEventData : CommandEndEventData
     {
         /// <summary>

diff --git a/src/EFCore.Relational/Diagnostics/CommandSource.cs b/src/EFCore.Relational/Diagnostics/CommandSource.cs
@@ -9,6 +9,9 @@ namespace Microsoft.EntityFrameworkCore.Diagnostics
     ///     Enum used by <see cref="CommandEventData" />, and subclasses to indicate the
     ///     source of the <see cref="DbCommand" /> being used to execute the command.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-diagnostics">Logging, events, and diagnostics</see> for more information.
+    /// </remarks>
     public enum CommandSource
     {
         /// <summary>