Fix broken links and various docs updates

Fixes dotnet/efcore#27290 Fixes dotnet/efcore#26667 Fixes dotnet/EntityFramework.Docs#3857 Fixes dotnet/EntityFramework.Docs#3837 Fixes dotnet/EntityFramework.Docs#3712
dotnet · May 11, 2022 · b9c1c82 · b9c1c82
1 parent 893a607
commit b9c1c82
Show file tree

Hide file tree

Showing 52 changed files with 78 additions and 76 deletions.
diff --git a/dotnet/xml/Microsoft.EntityFrameworkCore.Diagnostics/WarningsConfiguration.xml b/dotnet/xml/Microsoft.EntityFrameworkCore.Diagnostics/WarningsConfiguration.xml
@@ -32,7 +32,7 @@
                 </para>
     </summary>
     <remarks>
-                See <see href="https://aka.ms/efcore-warning-configuration">Configuration for specific messages</see> for more information.
+                See <see href="https://aka.ms/efcore-docs-warning-configuration">Configuration for specific messages</see> for more information.
             </remarks>
   </Docs>
   <Members>
@@ -353,7 +353,7 @@
             </summary>
         <returns>A new instance with the option changed.</returns>
         <remarks>
-                See <see href="https://aka.ms/efcore-warning-configuration">Configuration for specific messages</see> for more information.
+                See <see href="https://aka.ms/efcore-docs-warning-configuration">Configuration for specific messages</see> for more information.
             </remarks>
       </Docs>
     </Member>

diff --git a/dotnet/xml/Microsoft.EntityFrameworkCore.Diagnostics/WarningsConfigurationBuilder.xml b/dotnet/xml/Microsoft.EntityFrameworkCore.Diagnostics/WarningsConfigurationBuilder.xml
@@ -33,7 +33,7 @@
                 </para>
     </summary>
     <remarks>
-                See <see href="https://aka.ms/efcore-warning-configuration">Configuration for specific messages</see> for more information.
+                See <see href="https://aka.ms/efcore-docs-warning-configuration">Configuration for specific messages</see> for more information.
             </remarks>
   </Docs>
   <Members>
@@ -106,7 +106,7 @@
         </summary>
         <returns>The same builder instance so that multiple calls can be chained.</returns>
         <remarks>
-                See <see href="https://aka.ms/efcore-warning-configuration">Configuration for specific messages</see> for more information.
+                See <see href="https://aka.ms/efcore-docs-warning-configuration">Configuration for specific messages</see> for more information.
             </remarks>
       </Docs>
     </Member>
@@ -158,7 +158,7 @@
         </summary>
         <returns>The same builder instance so that multiple calls can be chained.</returns>
         <remarks>
-                See <see href="https://aka.ms/efcore-warning-configuration">Configuration for specific messages</see> for more information.
+                See <see href="https://aka.ms/efcore-docs-warning-configuration">Configuration for specific messages</see> for more information.
             </remarks>
       </Docs>
     </Member>
@@ -210,7 +210,7 @@
         </summary>
         <returns>The same builder instance so that multiple calls can be chained.</returns>
         <remarks>
-                See <see href="https://aka.ms/efcore-warning-configuration">Configuration for specific messages</see> for more information.
+                See <see href="https://aka.ms/efcore-docs-warning-configuration">Configuration for specific messages</see> for more information.
             </remarks>
       </Docs>
     </Member>
@@ -259,7 +259,7 @@
         </summary>
         <returns>The same builder instance so that multiple calls can be chained.</returns>
         <remarks>
-                See <see href="https://aka.ms/efcore-warning-configuration">Configuration for specific messages</see> for more information.
+                See <see href="https://aka.ms/efcore-docs-warning-configuration">Configuration for specific messages</see> for more information.
             </remarks>
       </Docs>
     </Member>
@@ -311,7 +311,7 @@
         </summary>
         <returns>The same builder instance so that multiple calls can be chained.</returns>
         <remarks>
-                See <see href="https://aka.ms/efcore-warning-configuration">Configuration for specific messages</see> for more information.
+                See <see href="https://aka.ms/efcore-docs-warning-configuration">Configuration for specific messages</see> for more information.
             </remarks>
       </Docs>
     </Member>

diff --git a/dotnet/xml/Microsoft.EntityFrameworkCore.Infrastructure/DatabaseFacade.xml b/dotnet/xml/Microsoft.EntityFrameworkCore.Infrastructure/DatabaseFacade.xml
@@ -308,7 +308,7 @@
         <returns>
           <see langword="true" /> if the database is available; <see langword="false" /> otherwise.</returns>
         <remarks>
-                See <see href="https://aka.ms/efcore-connections">Database connections in EF Core</see> for more information.
+                See <see href="https://aka.ms/efcore-docs-connections">Database connections in EF Core</see> for more information.
             </remarks>
       </Docs>
     </Member>
@@ -362,7 +362,7 @@
                     for more information.
                 </para>
           <para>
-                    See <see href="https://aka.ms/efcore-connections">Database connections in EF Core</see> for more information.
+                    See <see href="https://aka.ms/efcore-docs-connections">Database connections in EF Core</see> for more information.
                 </para>
         </remarks>
         <exception cref="T:System.OperationCanceledException">If the <see cref="T:System.Threading.CancellationToken" /> is canceled.</exception>
@@ -594,8 +594,8 @@
         <returns>
           <see langword="true" /> if the database is created, <see langword="false" /> if it already existed.</returns>
         <remarks>
-                See <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> for more information.
+                See <see href="https://aka.ms/efcore-docs-manage-schemas">Managing database schemas with EF Core</see>
+                and <see href="https://aka.ms/efcore-docs-ensure-created">Database creation APIs</see> for more information.
             </remarks>
       </Docs>
     </Member>
@@ -679,8 +679,8 @@
                     for more information.
                 </para>
           <para>
-                    See <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> for more information.
+                    See <see href="https://aka.ms/efcore-docs-manage-schemas">Managing database schemas with EF Core</see>
+                    and <see href="https://aka.ms/efcore-docs-ensure-created">Database creation APIs</see> for more information.
                 </para>
         </remarks>
         <exception cref="T:System.OperationCanceledException">If the <see cref="T:System.Threading.CancellationToken" /> is canceled.</exception>
@@ -732,8 +732,8 @@
         <returns>
           <see langword="true" /> if the database is deleted, <see langword="false" /> if it did not exist.</returns>
         <remarks>
-                See <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> for more information.
+                See <see href="https://aka.ms/efcore-docs-manage-schemas">Managing database schemas with EF Core</see>
+                and <see href="https://aka.ms/efcore-docs-ensure-created">Database creation APIs</see> for more information.
             </remarks>
       </Docs>
     </Member>
@@ -796,8 +796,8 @@
                     for more information.
                 </para>
           <para>
-                    See <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> for more information.
+                    See <see href="https://aka.ms/efcore-docs-manage-schemas">Managing database schemas with EF Core</see>
+                    and <see href="https://aka.ms/efcore-docs-ensure-created">Database creation APIs</see> for more information.
                 </para>
         </remarks>
         <exception cref="T:System.OperationCanceledException">If the <see cref="T:System.Threading.CancellationToken" /> is canceled.</exception>

diff --git a/dotnet/xml/Microsoft.EntityFrameworkCore.Infrastructure/DbContextAttribute.xml b/dotnet/xml/Microsoft.EntityFrameworkCore.Infrastructure/DbContextAttribute.xml
@@ -36,7 +36,7 @@
                 to identify which context a migration applies to.
             </summary>
     <remarks>
-                See <see href="https://aka.ms/efcore-manage-schemas">Managing database schemas with EF Cor</see> for more information.
+                See <see href="https://aka.ms/efcore-docs-manage-schemas">Managing database schemas with EF Cor</see> for more information.
             </remarks>
   </Docs>
   <Members>

diff --git a/dotnet/xml/Microsoft.EntityFrameworkCore.Infrastructure/IModelCacheKeyFactory.xml b/dotnet/xml/Microsoft.EntityFrameworkCore.Infrastructure/IModelCacheKeyFactory.xml
@@ -34,7 +34,7 @@
                 </para>
     </summary>
     <remarks>
-                See <see href="https://aka.ms/efcore-model-caching">EF Core model caching</see> for more information.
+                See <see href="https://aka.ms/efcore-docs-model-caching">EF Core model caching</see> for more information.
             </remarks>
   </Docs>
   <Members>

diff --git a/dotnet/xml/Microsoft.EntityFrameworkCore.Infrastructure/ModelCacheKey.xml b/dotnet/xml/Microsoft.EntityFrameworkCore.Infrastructure/ModelCacheKey.xml
@@ -33,7 +33,7 @@
                 </para>
     </summary>
     <remarks>
-                See <see href="https://aka.ms/efcore-model-caching">EF Core model caching</see> for more information.
+                See <see href="https://aka.ms/efcore-docs-model-caching">EF Core model caching</see> for more information.
             </remarks>
   </Docs>
   <Members>

diff --git a/dotnet/xml/Microsoft.EntityFrameworkCore.Infrastructure/ModelCacheKeyFactory.xml b/dotnet/xml/Microsoft.EntityFrameworkCore.Infrastructure/ModelCacheKeyFactory.xml
@@ -42,7 +42,7 @@
                 </para>
     </summary>
     <remarks>
-                See <see href="https://aka.ms/efcore-model-caching">EF Core model caching</see> for more information.
+                See <see href="https://aka.ms/efcore-docs-model-caching">EF Core model caching</see> for more information.
             </remarks>
   </Docs>
   <Members>

diff --git a/dotnet/xml/Microsoft.EntityFrameworkCore.Infrastructure/SqlServerDbContextOptionsBuilder.xml b/dotnet/xml/Microsoft.EntityFrameworkCore.Infrastructure/SqlServerDbContextOptionsBuilder.xml
@@ -295,8 +295,8 @@
       </AssemblyInfo>
       <Attributes>
         <Attribute FrameworkAlternate="efcore-3.1">
-          <AttributeName Language="C#">[System.Obsolete("Row-number paging is no longer supported. See https://ak.ms/AA6h122 for more information.")]</AttributeName>
-          <AttributeName Language="F#">[&lt;System.Obsolete("Row-number paging is no longer supported. See https://ak.ms/AA6h122 for more information.")&gt;]</AttributeName>
+          <AttributeName Language="C#">[System.Obsolete("Row-number paging is no longer supported. See https://aka.ms/AA6h122 for more information.")]</AttributeName>
+          <AttributeName Language="F#">[&lt;System.Obsolete("Row-number paging is no longer supported. See https://aka.ms/AA6h122 for more information.")&gt;]</AttributeName>
         </Attribute>
       </Attributes>
       <ReturnValue>

diff --git a/dotnet/xml/Microsoft.EntityFrameworkCore.Metadata.Builders/DbFunctionBuilder.xml b/dotnet/xml/Microsoft.EntityFrameworkCore.Metadata.Builders/DbFunctionBuilder.xml
@@ -333,7 +333,7 @@
                     function. The callback takes a collection of expressions corresponding to
                     the parameters passed to the function call. The callback should return an
                     expression representing the desired translation.
-                </para>
+          </para>
           <para>
                     See https://go.microsoft.com/fwlink/?linkid=852477 for more information.
                 </para>

diff --git a/dotnet/xml/Microsoft.EntityFrameworkCore.Metadata/ValueGenerated.xml b/dotnet/xml/Microsoft.EntityFrameworkCore.Metadata/ValueGenerated.xml
@@ -43,7 +43,7 @@
     </summary>
     <remarks>
                 See <see href="https://aka.ms/efcore-docs-modeling">Modeling entity types and relationships</see> and
-                See <see href="https://aka.ms/efcore-value-generation">Value generation in EF Core</see> for more information.
+                See <see href="https://aka.ms/efcore-docs-value-generation">Value generation in EF Core</see> for more information.
             </remarks>
   </Docs>
   <Members>

diff --git a/dotnet/xml/Microsoft.EntityFrameworkCore.Query/CollectionShaperExpression.xml b/dotnet/xml/Microsoft.EntityFrameworkCore.Query/CollectionShaperExpression.xml
@@ -37,7 +37,7 @@
     </summary>
     <remarks>
                 See <see href="https://aka.ms/efcore-docs-providers">Implementation of database providers and extensions</see>
-                and <see href="https://aka.ms/efcore-how-queries-work">How EF Core queries work</see> for more information.
+                and <see href="https://aka.ms/efcore-docs-how-query-works">How EF Core queries work</see> for more information.
             </remarks>
   </Docs>
   <Members>

diff --git a/dotnet/xml/Microsoft.EntityFrameworkCore.Query/CompiledQueryCacheKeyGenerator.xml b/dotnet/xml/Microsoft.EntityFrameworkCore.Query/CompiledQueryCacheKeyGenerator.xml
@@ -47,7 +47,7 @@
     </summary>
     <remarks>
                 See <see href="https://aka.ms/efcore-docs-providers">Implementation of database providers and extensions</see>
-                and <see href="https://aka.ms/efcore-how-queries-work">How EF Core queries work</see> for more information.
+                and <see href="https://aka.ms/efcore-docs-how-query-works">How EF Core queries work</see> for more information.
             </remarks>
   </Docs>
   <Members>

diff --git a/dotnet/xml/Microsoft.EntityFrameworkCore.Query/EntityShaperExpression.xml b/dotnet/xml/Microsoft.EntityFrameworkCore.Query/EntityShaperExpression.xml
@@ -31,7 +31,7 @@
     </summary>
     <remarks>
                 See <see href="https://aka.ms/efcore-docs-providers">Implementation of database providers and extensions</see>
-                and <see href="https://aka.ms/efcore-how-queries-work">How EF Core queries work</see> for more information.
+                and <see href="https://aka.ms/efcore-docs-how-query-works">How EF Core queries work</see> for more information.
             </remarks>
   </Docs>
   <Members>

diff --git a/dotnet/xml/Microsoft.EntityFrameworkCore.Query/EvaluatableExpressionFilter.xml b/dotnet/xml/Microsoft.EntityFrameworkCore.Query/EvaluatableExpressionFilter.xml
@@ -32,7 +32,7 @@
     </summary>
     <remarks>
                 See <see href="https://aka.ms/efcore-docs-providers">Implementation of database providers and extensions</see>
-                and <see href="https://aka.ms/efcore-how-queries-work">How EF Core queries work</see> for more information.
+                and <see href="https://aka.ms/efcore-docs-how-query-works">How EF Core queries work</see> for more information.
             </remarks>
   </Docs>
   <Members>

diff --git a/dotnet/xml/Microsoft.EntityFrameworkCore.Query/ExpressionEqualityComparer.xml b/dotnet/xml/Microsoft.EntityFrameworkCore.Query/ExpressionEqualityComparer.xml
@@ -23,7 +23,7 @@
             </summary>
     <remarks>
                 See <see href="https://aka.ms/efcore-docs-providers">Implementation of database providers and extensions</see>
-                and <see href="https://aka.ms/efcore-how-queries-work">How EF Core queries work</see> for more information.
+                and <see href="https://aka.ms/efcore-docs-how-query-works">How EF Core queries work</see> for more information.
             </remarks>
   </Docs>
   <Members>

diff --git a/dotnet/xml/Microsoft.EntityFrameworkCore.Query/ExpressionPrinter.xml b/dotnet/xml/Microsoft.EntityFrameworkCore.Query/ExpressionPrinter.xml
@@ -27,7 +27,7 @@
     </summary>
     <remarks>
                 See <see href="https://aka.ms/efcore-docs-providers">Implementation of database providers and extensions</see>
-                and <see href="https://aka.ms/efcore-how-queries-work">How EF Core queries work</see> for more information.
+                and <see href="https://aka.ms/efcore-docs-how-query-works">How EF Core queries work</see> for more information.
             </remarks>
   </Docs>
   <Members>

diff --git a/dotnet/xml/Microsoft.EntityFrameworkCore.Query/GroupByShaperExpression.xml b/dotnet/xml/Microsoft.EntityFrameworkCore.Query/GroupByShaperExpression.xml
@@ -31,7 +31,7 @@
     </summary>
     <remarks>
                 See <see href="https://aka.ms/efcore-docs-providers">Implementation of database providers and extensions</see>
-                and <see href="https://aka.ms/efcore-how-queries-work">How EF Core queries work</see> for more information.
+                and <see href="https://aka.ms/efcore-docs-how-query-works">How EF Core queries work</see> for more information.
             </remarks>
   </Docs>
   <Members>

diff --git a/dotnet/xml/Microsoft.EntityFrameworkCore.Query/IAsyncQueryProvider.xml b/dotnet/xml/Microsoft.EntityFrameworkCore.Query/IAsyncQueryProvider.xml
@@ -28,7 +28,7 @@
     </summary>
     <remarks>
                 See <see href="https://aka.ms/efcore-docs-providers">Implementation of database providers and extensions</see>
-                and <see href="https://aka.ms/efcore-how-queries-work">How EF Core queries work</see> for more information.
+                and <see href="https://aka.ms/efcore-docs-how-query-works">How EF Core queries work</see> for more information.
             </remarks>
   </Docs>
   <Members>

diff --git a/dotnet/xml/Microsoft.EntityFrameworkCore.Query/ICompiledQueryCacheKeyGenerator.xml b/dotnet/xml/Microsoft.EntityFrameworkCore.Query/ICompiledQueryCacheKeyGenerator.xml
@@ -35,7 +35,7 @@
     </summary>
     <remarks>
                 See <see href="https://aka.ms/efcore-docs-providers">Implementation of database providers and extensions</see>
-                and <see href="https://aka.ms/efcore-how-queries-work">How EF Core queries work</see> for more information.
+                and <see href="https://aka.ms/efcore-docs-how-query-works">How EF Core queries work</see> for more information.
             </remarks>
   </Docs>
   <Members>

diff --git a/dotnet/xml/Microsoft.EntityFrameworkCore.Query/IEntityMaterializerSource.xml b/dotnet/xml/Microsoft.EntityFrameworkCore.Query/IEntityMaterializerSource.xml
@@ -30,7 +30,7 @@
     </summary>
     <remarks>
                 See <see href="https://aka.ms/efcore-docs-providers">Implementation of database providers and extensions</see>
-                and <see href="https://aka.ms/efcore-how-queries-work">How EF Core queries work</see> for more information.
+                and <see href="https://aka.ms/efcore-docs-how-query-works">How EF Core queries work</see> for more information.
             </remarks>
   </Docs>
   <Members>

diff --git a/dotnet/xml/Microsoft.EntityFrameworkCore.Query/IEvaluatableExpressionFilter.xml b/dotnet/xml/Microsoft.EntityFrameworkCore.Query/IEvaluatableExpressionFilter.xml
@@ -25,7 +25,7 @@
     </summary>
     <remarks>
                 See <see href="https://aka.ms/efcore-docs-providers">Implementation of database providers and extensions</see>
-                and <see href="https://aka.ms/efcore-how-queries-work">How EF Core queries work</see> for more information.
+                and <see href="https://aka.ms/efcore-docs-how-query-works">How EF Core queries work</see> for more information.
             </remarks>
   </Docs>
   <Members>

diff --git a/dotnet/xml/Microsoft.EntityFrameworkCore.Query/IEvaluatableExpressionFilterPlugin.xml b/dotnet/xml/Microsoft.EntityFrameworkCore.Query/IEvaluatableExpressionFilterPlugin.xml
@@ -24,7 +24,7 @@
     </summary>
     <remarks>
                 See <see href="https://aka.ms/efcore-docs-providers">Implementation of database providers and extensions</see>
-                and <see href="https://aka.ms/efcore-how-queries-work">How EF Core queries work</see> for more information.
+                and <see href="https://aka.ms/efcore-docs-how-query-works">How EF Core queries work</see> for more information.
             </remarks>
   </Docs>
   <Members>

diff --git a/dotnet/xml/Microsoft.EntityFrameworkCore.Query/IIncludableQueryable`2.xml b/dotnet/xml/Microsoft.EntityFrameworkCore.Query/IIncludableQueryable`2.xml
@@ -57,7 +57,7 @@
             </summary>
     <remarks>
                 See <see href="https://aka.ms/efcore-docs-providers">Implementation of database providers and extensions</see>
-                and <see href="https://aka.ms/efcore-how-queries-work">How EF Core queries work</see> for more information.
+                and <see href="https://aka.ms/efcore-docs-how-query-works">How EF Core queries work</see> for more information.
             </remarks>
   </Docs>
   <Members />

diff --git a/dotnet/xml/Microsoft.EntityFrameworkCore.Query/IMemberTranslatorProvider.xml b/dotnet/xml/Microsoft.EntityFrameworkCore.Query/IMemberTranslatorProvider.xml
@@ -18,9 +18,10 @@
                     Provides translations for LINQ <see cref="T:System.Linq.Expressions.MemberExpression" /> expressions.
                 </para>
       <para>
-                    The service lifetime is <see cref="F:Microsoft.Extensions.DependencyInjection.ServiceLifetime.Singleton" />. This means a single instance
-                    is used by many <see cref="T:Microsoft.EntityFrameworkCore.DbContext" /> instances. The implementation must be thread-safe.
-                    This service cannot depend on services registered as <see cref="F:Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped" />.
+                    The service lifetime is <see cref="F:Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped" />. This means that each
+                    <see cref="T:Microsoft.EntityFrameworkCore.DbContext" /> instance will use its own instance of this service.
+                    The implementation may depend on other services registered with any lifetime.
+                    The implementation does not need to be thread-safe.
                 </para>
     </summary>
     <remarks>To be added.</remarks>

diff --git a/dotnet/xml/Microsoft.EntityFrameworkCore.Query/IMethodCallTranslatorPlugin.xml b/dotnet/xml/Microsoft.EntityFrameworkCore.Query/IMethodCallTranslatorPlugin.xml
@@ -18,10 +18,10 @@
                     Represents plugin for <see cref="T:Microsoft.EntityFrameworkCore.Query.IMethodCallTranslator" />.
                 </para>
       <para>
-                    The service lifetime is <see cref="F:Microsoft.Extensions.DependencyInjection.ServiceLifetime.Singleton" /> and multiple registrations
-                    are allowed. This means a single instance of each service is used by many <see cref="T:Microsoft.EntityFrameworkCore.DbContext" />
-                    instances. The implementation must be thread-safe.
-                    This service cannot depend on services registered as <see cref="F:Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped" />.
+                    The service lifetime is <see cref="F:Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped" />. This means that each
+                    <see cref="T:Microsoft.EntityFrameworkCore.DbContext" /> instance will use its own instance of this service.
+                    The implementation may depend on other services registered with any lifetime.
+                    The implementation does not need to be thread-safe.
                 </para>
     </summary>
     <remarks>To be added.</remarks>