More links to conceptual docs (#25814)

* More links to conceptual docs

Part of #17508

* Review updates

src/EFCore/Metadata/Builders/CollectionCollectionBuilder.cs

@@ -18,6 +18,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         and it is not designed to be directly constructed in your application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-modeling">Modeling entity types and relationships</see> for more information.
+    /// </remarks>
     public class CollectionCollectionBuilder
     {
         /// <summary>

src/EFCore/Metadata/Builders/CollectionCollectionBuilder`.cs

@@ -16,6 +16,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         and it is not designed to be directly constructed in your application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-modeling">Modeling entity types and relationships</see> for more information.
+    /// </remarks>
     /// <typeparam name="TLeftEntity"> One of the entity types in this relationship. </typeparam>
     /// <typeparam name="TRightEntity"> One of the entity types in this relationship. </typeparam>
     public class CollectionCollectionBuilder<TLeftEntity, TRightEntity> : CollectionCollectionBuilder

src/EFCore/Metadata/Builders/CollectionNavigationBuilder.cs

@@ -21,6 +21,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         and it is not designed to be directly constructed in your application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-modeling">Modeling entity types and relationships</see> for more information.
+    /// </remarks>
     public class CollectionNavigationBuilder : IInfrastructure<IConventionForeignKeyBuilder?>
     {
         /// <summary>

src/EFCore/Metadata/Builders/CollectionNavigationBuilder`.cs

@@ -21,6 +21,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         and it is not designed to be directly constructed in your application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-modeling">Modeling entity types and relationships</see> for more information.
+    /// </remarks>
     /// <typeparam name="TEntity"> The entity type to be configured. </typeparam>
     /// <typeparam name="TRelatedEntity"> The entity type that this relationship targets. </typeparam>
     public class CollectionNavigationBuilder<TEntity, TRelatedEntity> : CollectionNavigationBuilder

src/EFCore/Metadata/Builders/DataBuilder.cs

@@ -9,6 +9,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     /// <summary>
     ///     Allows further configuration of model data.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-modeling">Modeling entity types and relationships</see> for more information.
+    /// </remarks>
     public class DataBuilder
     {
         /// <summary>

src/EFCore/Metadata/Builders/DataBuilder`.cs

@@ -8,6 +8,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     /// <summary>
     ///     Allows further configuration of model data.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-modeling">Modeling entity types and relationships</see> for more information.
+    /// </remarks>
     /// <typeparam name="TEntity"> The entity type of the data. </typeparam>
     public class DataBuilder<TEntity> : DataBuilder
     {

src/EFCore/Metadata/Builders/DiscriminatorBuilder.cs

@@ -13,6 +13,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     /// <summary>
     ///     Provides a simple API surface for setting discriminator values.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-modeling">Modeling entity types and relationships</see> for more information.
+    /// </remarks>
     public class DiscriminatorBuilder : IConventionDiscriminatorBuilder
     {
         /// <summary>

src/EFCore/Metadata/Builders/DiscriminatorBuilder`.cs

@@ -10,6 +10,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     /// <summary>
     ///     Provides a simple API surface for setting discriminator values.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-modeling">Modeling entity types and relationships</see> for more information.
+    /// </remarks>
     /// <typeparam name="TDiscriminator"> The type of the discriminator property. </typeparam>
     public class DiscriminatorBuilder<TDiscriminator>
     {

src/EFCore/Metadata/Builders/EntityTypeBuilder.cs

@@ -24,6 +24,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         and it is not designed to be directly constructed in your application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-modeling">Modeling entity types and relationships</see> for more information.
+    /// </remarks>
     public class EntityTypeBuilder : IInfrastructure<IConventionEntityTypeBuilder>
     {
         /// <summary>

src/EFCore/Metadata/Builders/EntityTypeBuilder`.cs

@@ -21,6 +21,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         and it is not designed to be directly constructed in your application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-modeling">Modeling entity types and relationships</see> for more information.
+    /// </remarks>
     /// <typeparam name="TEntity"> The entity type being configured. </typeparam>
     public class EntityTypeBuilder<TEntity> : EntityTypeBuilder
         where TEntity : class

src/EFCore/Metadata/Builders/IConventionAnnotatableBuilder.cs

@@ -14,6 +14,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         not used in application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-conventions">Model building conventions</see> for more information.
+    /// </remarks>
     public interface IConventionAnnotatableBuilder
     {
         /// <summary>

src/EFCore/Metadata/Builders/IConventionDiscriminatorBuilder.cs

@@ -8,6 +8,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     /// <summary>
     ///     Provides a simple API surface for setting discriminator values from conventions.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-conventions">Model building conventions</see> for more information.
+    /// </remarks>
     public interface IConventionDiscriminatorBuilder
     {
         /// <summary>

src/EFCore/Metadata/Builders/IConventionEntityTypeBuilder.cs

@@ -17,6 +17,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         not used in application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-conventions">Model building conventions</see> for more information.
+    /// </remarks>
     public interface IConventionEntityTypeBuilder : IConventionAnnotatableBuilder
     {
         /// <summary>

src/EFCore/Metadata/Builders/IConventionForeignKeyBuilder.cs

@@ -15,6 +15,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         not used in application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-conventions">Model building conventions</see> for more information.
+    /// </remarks>
     public interface IConventionForeignKeyBuilder : IConventionAnnotatableBuilder
     {
         /// <summary>

src/EFCore/Metadata/Builders/IConventionIndexBuilder.cs

@@ -12,6 +12,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         not used in application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-conventions">Model building conventions</see> for more information.
+    /// </remarks>
     public interface IConventionIndexBuilder : IConventionAnnotatableBuilder
     {
         /// <summary>

src/EFCore/Metadata/Builders/IConventionKeyBuilder.cs

@@ -12,6 +12,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         not used in application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-conventions">Model building conventions</see> for more information.
+    /// </remarks>
     public interface IConventionKeyBuilder : IConventionAnnotatableBuilder
     {
         /// <summary>

src/EFCore/Metadata/Builders/IConventionModelBuilder.cs

@@ -14,6 +14,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         not used in application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-conventions">Model building conventions</see> for more information.
+    /// </remarks>
     public interface IConventionModelBuilder : IConventionAnnotatableBuilder
     {
         /// <summary>

src/EFCore/Metadata/Builders/IConventionNavigationBuilder.cs

@@ -14,6 +14,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         not used in application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-conventions">Model building conventions</see> for more information.
+    /// </remarks>
     public interface IConventionNavigationBuilder : IConventionPropertyBaseBuilder
     {
         /// <summary>

src/EFCore/Metadata/Builders/IConventionOwnedEntityTypeBuilder.cs

@@ -7,6 +7,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///     This interface is typically used by database providers (and other extensions). It is generally
     ///     not used in application code.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-conventions">Model building conventions</see> for more information.
+    /// </remarks>
     public interface IConventionOwnedEntityTypeBuilder
     {
     }

src/EFCore/Metadata/Builders/IConventionPropertyBaseBuilder.cs

@@ -15,6 +15,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         not used in application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-conventions">Model building conventions</see> for more information.
+    /// </remarks>
     public interface IConventionPropertyBaseBuilder : IConventionAnnotatableBuilder
     {
         /// <summary>

src/EFCore/Metadata/Builders/IConventionPropertyBuilder.cs

@@ -19,6 +19,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         not used in application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-conventions">Model building conventions</see> for more information.
+    /// </remarks>
     public interface IConventionPropertyBuilder : IConventionPropertyBaseBuilder
     {
         /// <summary>

src/EFCore/Metadata/Builders/IConventionServicePropertyBuilder.cs

@@ -14,6 +14,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         not used in application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-conventions">Model building conventions</see> for more information.
+    /// </remarks>
     public interface IConventionServicePropertyBuilder : IConventionPropertyBaseBuilder
     {
         /// <summary>

src/EFCore/Metadata/Builders/IConventionSkipNavigationBuilder.cs

@@ -14,6 +14,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         not used in application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-conventions">Model building conventions</see> for more information.
+    /// </remarks>
     public interface IConventionSkipNavigationBuilder : IConventionPropertyBaseBuilder
     {
         /// <summary>

src/EFCore/Metadata/Builders/IndexBuilder.cs

@@ -17,6 +17,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         and it is not designed to be directly constructed in your application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-modeling">Modeling entity types and relationships</see> for more information.
+    /// </remarks>
     public class IndexBuilder : IInfrastructure<IConventionIndexBuilder>
     {
         /// <summary>

src/EFCore/Metadata/Builders/IndexBuilder`.cs

@@ -14,6 +14,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         and it is not designed to be directly constructed in your application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-modeling">Modeling entity types and relationships</see> for more information.
+    /// </remarks>
     // ReSharper disable once UnusedTypeParameter
     public class IndexBuilder<T> : IndexBuilder
     {

src/EFCore/Metadata/Builders/InvertibleRelationshipBuilderBase.cs

@@ -14,6 +14,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     /// <summary>
     ///     Base class used for configuring an invertible relationship.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-modeling">Modeling entity types and relationships</see> for more information.
+    /// </remarks>
     public abstract class InvertibleRelationshipBuilderBase : IInfrastructure<IConventionForeignKeyBuilder>
     {
         private readonly IReadOnlyList<Property>? _foreignKeyProperties;

src/EFCore/Metadata/Builders/KeyBuilder.cs

@@ -17,6 +17,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         and it is not designed to be directly constructed in your application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-modeling">Modeling entity types and relationships</see> for more information.
+    /// </remarks>
     public class KeyBuilder : IInfrastructure<IConventionKeyBuilder>
     {
         /// <summary>

src/EFCore/Metadata/Builders/KeyBuilder`.cs

@@ -14,6 +14,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         and it is not designed to be directly constructed in your application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-modeling">Modeling entity types and relationships</see> for more information.
+    /// </remarks>
     // ReSharper disable once UnusedTypeParameter
     public class KeyBuilder<T> : KeyBuilder
     {

src/EFCore/Metadata/Builders/NavigationBuilder.cs

@@ -19,6 +19,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         and it is not designed to be directly constructed in your application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-modeling">Modeling entity types and relationships</see> for more information.
+    /// </remarks>
     public class NavigationBuilder : IInfrastructure<IConventionSkipNavigationBuilder?>, IInfrastructure<IConventionNavigationBuilder?>
     {
         /// <summary>

src/EFCore/Metadata/Builders/NavigationBuilder`.cs

@@ -15,6 +15,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         and it is not designed to be directly constructed in your application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-modeling">Modeling entity types and relationships</see> for more information.
+    /// </remarks>
     public class NavigationBuilder<TSource, TTarget> : NavigationBuilder
         where TSource : class
         where TTarget : class

src/EFCore/Metadata/Builders/OwnedEntityTypeBuilder.cs

@@ -12,6 +12,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         and it is not designed to be directly constructed in your application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-modeling">Modeling entity types and relationships</see> for more information.
+    /// </remarks>
     public class OwnedEntityTypeBuilder
     {
         /// <summary>

src/EFCore/Metadata/Builders/OwnedEntityTypeBuilder`.cs

@@ -11,6 +11,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         and it is not designed to be directly constructed in your application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-modeling">Modeling entity types and relationships</see> for more information.
+    /// </remarks>
     /// <typeparam name="T"> The entity type being configured. </typeparam>
     // ReSharper disable once UnusedTypeParameter
     public class OwnedEntityTypeBuilder<T> : OwnedEntityTypeBuilder

src/EFCore/Metadata/Builders/OwnedNavigationBuilder.cs

@@ -14,6 +14,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     /// <summary>
     ///     Provides a simple API for configuring a navigation to an owned entity type.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-modeling">Modeling entity types and relationships</see> for more information.
+    /// </remarks>
     public class OwnedNavigationBuilder : IInfrastructure<IConventionEntityTypeBuilder>
     {
         private InternalForeignKeyBuilder _builder;

src/EFCore/Metadata/Builders/OwnedNavigationBuilder`.cs

@@ -15,6 +15,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     /// <summary>
     ///     Provides a simple API for configuring a navigation to an owned entity type.
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-modeling">Modeling entity types and relationships</see> for more information.
+    /// </remarks>
     public class OwnedNavigationBuilder<TOwnerEntity, TDependentEntity> : OwnedNavigationBuilder
         where TOwnerEntity : class
         where TDependentEntity : class

src/EFCore/Metadata/Builders/OwnershipBuilder.cs

@@ -13,6 +13,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         Provides a simple API for configuring an ownership.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-modeling">Modeling entity types and relationships</see> for more information.
+    /// </remarks>
     public class OwnershipBuilder : RelationshipBuilderBase
     {
         /// <summary>

src/EFCore/Metadata/Builders/OwnershipBuilder`.cs

@@ -15,6 +15,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         Provides a simple API for configuring an ownership.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-modeling">Modeling entity types and relationships</see> for more information.
+    /// </remarks>
     public class OwnershipBuilder<TEntity, TDependentEntity> : OwnershipBuilder
         where TEntity : class
         where TDependentEntity : class

src/EFCore/Metadata/Builders/PropertiesConfigurationBuilder.cs

@@ -20,6 +20,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         and it is not designed to be directly constructed in your application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-modeling">Modeling entity types and relationships</see> for more information.
+    /// </remarks>
     public class PropertiesConfigurationBuilder
     {
         /// <summary>

src/EFCore/Metadata/Builders/PropertiesConfigurationBuilder`.cs

@@ -18,6 +18,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         and it is not designed to be directly constructed in your application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-modeling">Modeling entity types and relationships</see> for more information.
+    /// </remarks>
     public class PropertiesConfigurationBuilder<TProperty> : PropertiesConfigurationBuilder
     {
         /// <summary>

src/EFCore/Metadata/Builders/PropertyBuilder.cs

@@ -21,6 +21,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         and it is not designed to be directly constructed in your application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-modeling">Modeling entity types and relationships</see> for more information.
+    /// </remarks>
     public class PropertyBuilder : IInfrastructure<IConventionPropertyBuilder>
     {
         /// <summary>

src/EFCore/Metadata/Builders/PropertyBuilder`.cs

@@ -20,6 +20,9 @@ namespace Microsoft.EntityFrameworkCore.Metadata.Builders
     ///         and it is not designed to be directly constructed in your application code.
     ///     </para>
     /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-modeling">Modeling entity types and relationships</see> for more information.
+    /// </remarks>
     public class PropertyBuilder<TProperty> : PropertyBuilder
     {
         /// <summary>