Docs tweaks and package generator in shared framework

Author: captainsafia

src/Framework/App.Ref/src/Microsoft.AspNetCore.App.Ref.sfxproj

@@ -76,6 +76,11 @@
       Private="false"
       OutputItemType="AspNetCoreAnalyzer"
       ReferenceOutputAssembly="false" />
+
+    <ProjectReference Include="$(RepoRoot)src\Http\Http.Extensions\gen\Microsoft.AspNetCore.Http.ValidationsGenerator\Microsoft.AspNetCore.Http.ValidationsGenerator.csproj"
+      Private="false"
+      OutputItemType="AspNetCoreAnalyzer"
+      ReferenceOutputAssembly="false" />
   </ItemGroup>
 
   <ItemGroup>

src/Http/Http.Abstractions/src/Validation/IValidatableInfoResolver.cs

@@ -6,7 +6,8 @@
 namespace Microsoft.AspNetCore.Http.Validation;
 
 /// <summary>
-/// Resolves validation type information for a given type.
+/// Provides an interface for resolving the validation information associated
+/// with a given <seealso cref="Type"/> or <seealso cref="ParameterInfo"/>.
 /// </summary>
 public interface IValidatableInfoResolver
 {

src/Http/Http.Abstractions/src/Validation/ValidatableParameterInfo.cs

@@ -78,7 +78,12 @@ public ValidatableParameterInfo(
     /// Validates the parameter value.
     /// </summary>
     /// <param name="value">The value to validate.</param>
-    /// <param name="context"></param>
+    /// <param name="context">The context for the validation.</param>
+    /// <returns>A task representing the asynchronous operation.</returns>
+    /// <remarks>
+    /// If the parameter is a collection, each item in the collection will be validated.
+    /// If the parameter is not a collection but has a validatable type, the single value will be validated.
+    /// </remarks>
     public Task Validate(object? value, ValidatableContext context)
     {
         Debug.Assert(context.ValidationContext is not null);

src/Http/Http.Abstractions/src/Validation/ValidatablePropertyInfo.cs

@@ -87,7 +87,8 @@ public ValidatablePropertyInfo(
     /// Validates the member's value.
     /// </summary>
     /// <param name="obj">The object containing the member to validate.</param>
-    /// <param name="context"></param>
+    /// <param name="context">The context for the validation.</param>
+    /// <returns>A task representing the asynchronous operation.</returns>
     public Task Validate(object obj, ValidatableContext context)
     {
         Debug.Assert(context.ValidationContext is not null);

src/Http/Http.Abstractions/src/Validation/ValidationServiceCollectionExtensions.cs

@@ -13,13 +13,14 @@ public static class ValidationServiceCollectionExtensions
     /// <summary>
     /// Adds the validation services to the specified <see cref="IServiceCollection" />.
     /// </summary>
-    /// <param name="services"></param>
-    /// <param name="configureOptions"></param>
-    /// <returns></returns>
+    /// <param name="services">The <see cref="IServiceCollection" /> to add the services to.</param>
+    /// <param name="configureOptions">An optional action to configure the <see cref="ValidationOptions"/>.</param>
+    /// <returns>The <see cref="IServiceCollection" /> for chaining.</returns>
     public static IServiceCollection AddValidation(this IServiceCollection services, Action<ValidationOptions>? configureOptions = null)
     {
         if (configureOptions is null)
         {
+            services.Configure<ValidationOptions>(_ => { });
             return services;
         }