More links to conceptual docs

Part of #17508

src/EFCore/Extensions/ConventionAnnotatableExtensions.cs

@@ -2,10 +2,7 @@
 // The .NET Foundation licenses this file to you under the MIT license.
 
 using System;
-using System.Collections.Generic;
-using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Metadata;
-using Microsoft.EntityFrameworkCore.Metadata.Internal;
 
 // ReSharper disable once CheckNamespace
 namespace Microsoft.EntityFrameworkCore

src/EFCore/Extensions/MutableAnnotatableExtensions.cs

@@ -2,10 +2,7 @@
 // The .NET Foundation licenses this file to you under the MIT license.
 
 using System;
-using System.Collections.Generic;
-using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Metadata;
-using Microsoft.EntityFrameworkCore.Metadata.Internal;
 
 // ReSharper disable once CheckNamespace
 namespace Microsoft.EntityFrameworkCore

src/EFCore/Extensions/TransactionsDatabaseFacadeExtensions.cs

@@ -19,6 +19,9 @@ public static class TransactionsDatabaseFacadeExtensions
         /// <summary>
         ///     Specifies an existing <see cref="Transaction" /> to be used for database operations.
         /// </summary>
+        /// <remarks>
+        ///     For more information, see <see href="https://aka.ms/efcore-docs-transactions">Transactions in EF Core</see>.
+        /// </remarks>
         /// <param name="databaseFacade"> The <see cref="DatabaseFacade" /> for the context.</param>
         /// <param name="transaction"> The transaction to be used. </param>
         public static void EnlistTransaction(this DatabaseFacade databaseFacade, Transaction? transaction)
@@ -38,6 +41,9 @@ public static void EnlistTransaction(this DatabaseFacade databaseFacade, Transac
         /// <summary>
         ///     Returns the currently enlisted transaction.
         /// </summary>
+        /// <remarks>
+        ///     For more information, see <see href="https://aka.ms/efcore-docs-transactions">Transactions in EF Core</see>.
+        /// </remarks>
         /// <param name="databaseFacade"> The <see cref="DatabaseFacade" /> for the context.</param>
         /// <returns> The currently enlisted transaction. </returns>
         public static Transaction? GetEnlistedTransaction(this DatabaseFacade databaseFacade)

src/EFCore/Infrastructure/AccessorExtensions.cs

@@ -29,14 +29,13 @@ public static class AccessorExtensions
         ///         <see cref="IInfrastructure{IServiceProvider}" />.
         ///     </para>
         ///     <para>
-        ///         This method is typically used by database providers (and other extensions). It is generally
-        ///         not used in application code.
-        ///     </para>
-        ///     <para>
         ///         <see cref="IInfrastructure{T}" /> is used to hide properties that are not intended to be used in
         ///         application code but can be used in extension methods written by database providers etc.
         ///     </para>
         /// </summary>
+        /// <remarks>
+        ///     For more information, <see href="https://aka.ms/efcore-docs-services">Accessing DbContext services</see>.
+        /// </remarks>
         /// <typeparam name="TService"> The type of service to be resolved. </typeparam>
         /// <param name="accessor"> The object exposing the service provider. </param>
         /// <returns> The requested service. </returns>

src/EFCore/Infrastructure/Annotatable.cs

@@ -17,6 +17,9 @@ namespace Microsoft.EntityFrameworkCore.Infrastructure
     ///         not used in application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-providers">Implementation of database providers and extensions</see>.
+    /// </remarks>
     public class Annotatable : AnnotatableBase, IMutableAnnotatable
     {
         /// <summary>

src/EFCore/Infrastructure/AnnotatableBase.cs

@@ -21,6 +21,9 @@ namespace Microsoft.EntityFrameworkCore.Infrastructure
     ///         not used in application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-providers">Implementation of database providers and extensions</see>.
+    /// </remarks>
     public class AnnotatableBase : IAnnotatable
     {
         private SortedDictionary<string, Annotation>? _annotations;

src/EFCore/Infrastructure/AnnotatableBuilder.cs

@@ -17,6 +17,9 @@ namespace Microsoft.EntityFrameworkCore.Infrastructure
     ///         not used in application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-providers">Implementation of database providers and extensions</see>.
+    /// </remarks>
     [DebuggerDisplay("Builder {" + nameof(Metadata) + ",nq}")]
     public abstract class AnnotatableBuilder<TMetadata, TModelBuilder> : IConventionAnnotatableBuilder
         where TMetadata : ConventionAnnotatable

src/EFCore/Infrastructure/Annotation.cs

@@ -14,6 +14,9 @@ namespace Microsoft.EntityFrameworkCore.Infrastructure
     ///         not used in application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-providers">Implementation of database providers and extensions</see>.
+    /// </remarks>
     public class Annotation : IAnnotation
     {
         /// <summary>

src/EFCore/Infrastructure/ConcurrencyDetectorCriticalSectionDisposer.cs

@@ -9,6 +9,9 @@ namespace Microsoft.EntityFrameworkCore.Infrastructure
     ///     A <see cref="IDisposable" /> returned by an <see cref="IConcurrencyDetector" />, which will exit the ongoing
     ///     critical section when disposed.
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-providers">Implementation of database providers and extensions</see>.
+    /// </remarks>
     public readonly struct ConcurrencyDetectorCriticalSectionDisposer : IDisposable
     {
         private readonly IConcurrencyDetector _concurrencyDetector;

src/EFCore/Infrastructure/ConventionAnnotatable.cs

@@ -20,6 +20,9 @@ namespace Microsoft.EntityFrameworkCore.Infrastructure
     ///         not used in application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-providers">Implementation of database providers and extensions</see>.
+    /// </remarks>
     public abstract class ConventionAnnotatable : Annotatable, IConventionAnnotatable, IMutableAnnotatable
     {
         /// <summary>

src/EFCore/Infrastructure/CoreOptionsExtension.cs

@@ -25,6 +25,9 @@ namespace Microsoft.EntityFrameworkCore.Infrastructure
     ///         methods to obtain a new instance with the option changed.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-docs-providers">Implementation of database providers and extensions</see>.
+    /// </remarks>
     public class CoreOptionsExtension : IDbContextOptionsExtension
     {
         private IServiceProvider? _internalServiceProvider;

src/EFCore/Infrastructure/DatabaseFacade.cs

@@ -74,6 +74,10 @@ private IDatabaseFacadeDependencies Dependencies
         ///         to ensure the database is created using migrations and that all migrations have been applied.
         ///     </para>
         /// </summary>
+        /// <remarks>
+        ///     For more information, <see href="https://aka.ms/efcore-manage-schemas">Managing database schemas with EF Core</see>
+        ///     and <see href="https://aka.ms/efcore-ensure-created">Database creation APIs</see>.
+        /// </remarks>
         /// <returns> <see langword="true" /> if the database is created, <see langword="false" /> if it already existed. </returns>
         public virtual bool EnsureCreated()
             => Dependencies.DatabaseCreator.EnsureCreated();
@@ -114,6 +118,10 @@ public virtual bool EnsureCreated()
         ///         to ensure the database is created using migrations and that all migrations have been applied.
         ///     </para>
         /// </summary>
+        /// <remarks>
+        ///     For more information, <see href="https://aka.ms/efcore-manage-schemas">Managing database schemas with EF Core</see>
+        ///     and <see href="https://aka.ms/efcore-ensure-created">Database creation APIs</see>.
+        /// </remarks>
         /// <param name="cancellationToken">A <see cref="CancellationToken" /> to observe while waiting for the task to complete.</param>
         /// <returns>
         ///     A task that represents the asynchronous save operation. The task result contains <see langword="true" /> if the database is created,
@@ -138,6 +146,10 @@ public virtual Task<bool> EnsureCreatedAsync(CancellationToken cancellationToken
         ///         execution of the test/prototype. Note, however, that data in the database is not preserved.
         ///     </para>
         /// </summary>
+        /// <remarks>
+        ///     For more information, <see href="https://aka.ms/efcore-manage-schemas">Managing database schemas with EF Core</see>
+        ///     and <see href="https://aka.ms/efcore-ensure-created">Database creation APIs</see>.
+        /// </remarks>
         /// <returns> <see langword="true" /> if the database is deleted, <see langword="false" /> if it did not exist. </returns>
         public virtual bool EnsureDeleted()
             => Dependencies.DatabaseCreator.EnsureDeleted();
@@ -157,6 +169,10 @@ public virtual bool EnsureDeleted()
         ///         execution of the test/prototype. Note, however, that data in the database is not preserved.
         ///     </para>
         /// </summary>
+        /// <remarks>
+        ///     For more information, <see href="https://aka.ms/efcore-manage-schemas">Managing database schemas with EF Core</see>
+        ///     and <see href="https://aka.ms/efcore-ensure-created">Database creation APIs</see>.
+        /// </remarks>
         /// <param name="cancellationToken">A <see cref="CancellationToken" /> to observe while waiting for the task to complete.</param>
         /// <returns>
         ///     A task that represents the asynchronous save operation. The task result contains <see langword="true" /> if the database is deleted,
@@ -182,6 +198,9 @@ public virtual Task<bool> EnsureDeletedAsync(CancellationToken cancellationToken
         ///         up-to-date with regard to schema creation, etc.
         ///     </para>
         /// </summary>
+        /// <remarks>
+        ///     For more information, <see href="https://aka.ms/efcore-connections">Database connections in EF Core</see>.
+        /// </remarks>
         /// <returns> <see langword="true" /> if the database is available; <see langword="false" /> otherwise. </returns>
         public virtual bool CanConnect()
             => Dependencies.DatabaseCreator.CanConnect();
@@ -202,6 +221,9 @@ public virtual bool CanConnect()
         ///         up-to-date with regard to schema creation, etc.
         ///     </para>
         /// </summary>
+        /// <remarks>
+        ///     For more information, <see href="https://aka.ms/efcore-connections">Database connections in EF Core</see>.
+        /// </remarks>
         /// <param name="cancellationToken">A <see cref="CancellationToken" /> to observe while waiting for the task to complete.</param>
         /// <returns> <see langword="true" /> if the database is available; <see langword="false" /> otherwise. </returns>
         /// <exception cref="OperationCanceledException"> If the <see cref="CancellationToken"/> is canceled. </exception>
@@ -211,6 +233,9 @@ public virtual Task<bool> CanConnectAsync(CancellationToken cancellationToken =
         /// <summary>
         ///     Starts a new transaction.
         /// </summary>
+        /// <remarks>
+        ///     For more information, see <see href="https://aka.ms/efcore-docs-transactions">Transactions in EF Core</see>.
+        /// </remarks>
         /// <returns>
         ///     A <see cref="IDbContextTransaction" /> that represents the started transaction.
         /// </returns>
@@ -220,6 +245,9 @@ public virtual IDbContextTransaction BeginTransaction()
         /// <summary>
         ///     Asynchronously starts a new transaction.
         /// </summary>
+        /// <remarks>
+        ///     For more information, see <see href="https://aka.ms/efcore-docs-transactions">Transactions in EF Core</see>.
+        /// </remarks>
         /// <param name="cancellationToken">A <see cref="CancellationToken" /> to observe while waiting for the task to complete.</param>
         /// <returns>
         ///     A task that represents the asynchronous transaction initialization. The task result contains a <see cref="IDbContextTransaction" />
@@ -238,6 +266,9 @@ public virtual void CommitTransaction()
         /// <summary>
         ///     Applies the outstanding operations in the current transaction to the database.
         /// </summary>
+        /// <remarks>
+        ///     For more information, see <see href="https://aka.ms/efcore-docs-transactions">Transactions in EF Core</see>.
+        /// </remarks>
         /// <param name="cancellationToken">A <see cref="CancellationToken" /> to observe while waiting for the task to complete.</param>
         /// <returns> A Task representing the asynchronous operation. </returns>
         /// <exception cref="OperationCanceledException"> If the <see cref="CancellationToken"/> is canceled. </exception>
@@ -247,12 +278,18 @@ public virtual Task CommitTransactionAsync(CancellationToken cancellationToken =
         /// <summary>
         ///     Discards the outstanding operations in the current transaction.
         /// </summary>
+        /// <remarks>
+        ///     For more information, see <see href="https://aka.ms/efcore-docs-transactions">Transactions in EF Core</see>.
+        /// </remarks>
         public virtual void RollbackTransaction()
             => Dependencies.TransactionManager.RollbackTransaction();
 
         /// <summary>
         ///     Discards the outstanding operations in the current transaction.
         /// </summary>
+        /// <remarks>
+        ///     For more information, see <see href="https://aka.ms/efcore-docs-transactions">Transactions in EF Core</see>.
+        /// </remarks>
         /// <param name="cancellationToken">A <see cref="CancellationToken" /> to observe while waiting for the task to complete.</param>
         /// <returns> A Task representing the asynchronous operation. </returns>
         /// <exception cref="OperationCanceledException"> If the <see cref="CancellationToken"/> is canceled. </exception>
@@ -262,6 +299,9 @@ public virtual Task RollbackTransactionAsync(CancellationToken cancellationToken
         /// <summary>
         ///     Creates an instance of the configured <see cref="IExecutionStrategy" />.
         /// </summary>
+        /// <remarks>
+        ///     For more information, see <see href="https://aka.ms/efcore-docs-connection-resiliency">EF Core Connection Resiliency</see>.
+        /// </remarks>
         /// <returns>An <see cref="IExecutionStrategy" /> instance.</returns>
         public virtual IExecutionStrategy CreateExecutionStrategy()
             => Dependencies.ExecutionStrategyFactory.Create();
@@ -284,6 +324,9 @@ public virtual IExecutionStrategy CreateExecutionStrategy()
         ///         on the returned <see cref="IDbContextTransaction" />.
         ///     </para>
         /// </summary>
+        /// <remarks>
+        ///     For more information, see <see href="https://aka.ms/efcore-docs-transactions">Transactions in EF Core</see>.
+        /// </remarks>
         public virtual IDbContextTransaction? CurrentTransaction
             => Dependencies.TransactionManager.CurrentTransaction;
 
@@ -306,6 +349,9 @@ public virtual IDbContextTransaction? CurrentTransaction
         ///         could be left in a corrupted state if <see cref="DbContext.SaveChanges()" /> fails.
         ///     </para>
         /// </summary>
+        /// <remarks>
+        ///     For more information, see <see href="https://aka.ms/efcore-docs-transactions">Transactions in EF Core</see>.
+        /// </remarks>
         public virtual bool AutoTransactionsEnabled { get; set; } = true;
 
         /// <summary>
@@ -323,6 +369,9 @@ public virtual IDbContextTransaction? CurrentTransaction
         ///         corrupted state if <see cref="DbContext.SaveChanges()" /> fails.
         ///     </para>
         /// </summary>
+        /// <remarks>
+        ///     For more information, see <see href="https://aka.ms/efcore-docs-transactions">Transactions in EF Core</see>.
+        /// </remarks>
         public virtual bool AutoSavepointsEnabled { get; set; } = true;
 
         /// <summary>
@@ -340,6 +389,10 @@ public virtual IDbContextTransaction? CurrentTransaction
         ///         provider to use as part of configuring the context.
         ///     </para>
         /// </summary>
+        /// <remarks>
+        ///     For more information,
+        ///     <see href="https://aka.ms/efcore-docs-dbcontext">DbContext lifetime, configuration, and initialization</see>.
+        /// </remarks>
         public virtual string? ProviderName
             // Needs to be lazy because used from OnModelCreating
             => _context.GetService<IEnumerable<IDatabaseProvider>>()
@@ -355,6 +408,9 @@ public virtual string? ProviderName
         ///         not directly exposed in the public API surface.
         ///     </para>
         /// </summary>
+        /// <remarks>
+        ///     For more information, <see href="https://aka.ms/efcore-docs-providers">Implementation of database providers and extensions</see>.
+        /// </remarks>
         IServiceProvider IInfrastructure<IServiceProvider>.Instance
             => ((IInfrastructure<IServiceProvider>)_context).Instance;
 

src/EFCore/Infrastructure/DbContextAttribute.cs

@@ -10,6 +10,9 @@ namespace Microsoft.EntityFrameworkCore.Infrastructure
     ///     Identifies the <see cref="DbContext" /> that a class belongs to. For example, this attribute is used
     ///     to identify which context a migration applies to.
     /// </summary>
+    /// <remarks>
+    ///     For more information, <see href="https://aka.ms/efcore-manage-schemas">Managing database schemas with EF Cor</see>.
+    /// </remarks>
     [AttributeUsage(AttributeTargets.Class)]
     public sealed class DbContextAttribute : Attribute
     {