Add doc comments

Author: captainsafia

src/Http/Http.Abstractions/src/Validation/ValidatableContext.cs

@@ -10,9 +10,29 @@ namespace Microsoft.AspNetCore.Http.Validation;
 /// </summary>
 public sealed class ValidatableContext
 {
+    /// <summary>
+    /// Gets or sets the validation context used for validating objects that implement <see cref="IValidatableObject"/> or have <see cref="ValidationAttribute"/>.
+    /// This context provides access to service provider and other validation metadata.
+    /// </summary>
     public ValidationContext? ValidationContext { get; set; }
+
+    /// <summary>
+    /// Gets or sets the prefix used to identify the current object being validated in a complex object graph.
+    /// This is used to build property paths in validation error messages (e.g., "Customer.Address.Street").
+    /// </summary>
     public string Prefix { get; set; } = string.Empty;
+
+    /// <summary>
+    /// Gets or sets the validation options that control validation behavior,
+    /// including validation depth limits and resolver registration.
+    /// </summary>
     public required ValidationOptions ValidationOptions { get; set; }
+
+    /// <summary>
+    /// Gets or sets the dictionary of validation errors collected during validation.
+    /// Keys are property names or paths, and values are arrays of error messages.
+    /// This dictionary is lazily initialized when the first validation error is added.
+    /// </summary>
     public Dictionary<string, string[]>? ValidationErrors { get; set; }
 
     internal void AddValidationError(string key, string[] error)

src/Http/Http.Abstractions/src/Validation/ValidationOptions.cs

@@ -6,11 +6,35 @@
 
 namespace Microsoft.AspNetCore.Http.Validation;
 
+/// <summary>
+/// Provides configuration options for the validation system.
+/// </summary>
 public class ValidationOptions
 {
+    /// <summary>
+    /// Gets the list of resolvers that provide validation metadata for types and parameters.
+    /// Resolvers are processed in order, with the first resolver providing a non-null result being used.
+    /// </summary>
+    /// <remarks>
+    /// Source-generated resolvers are typically inserted at the beginning of this list
+    /// to ensure they are checked before any runtime-based resolvers.
+    /// </remarks>
     public IList<IValidatableInfoResolver> Resolvers { get; } = [];
+
+    /// <summary>
+    /// Gets or sets the maximum depth for validation of nested objects.
+    /// This prevents stack overflows from circular references or extremely deep object graphs.
+    /// Default value is 32.
+    /// </summary>
     public int MaxDepth { get; set; } = 32;
 
+    /// <summary>
+    /// Attempts to get validation information for the specified type.
+    /// </summary>
+    /// <param name="type">The type to get validation information for.</param>
+    /// <param name="validatableTypeInfo">When this method returns, contains the validation information for the specified type,
+    /// if the type was found; otherwise, null.</param>
+    /// <returns>true if validation information was found for the specified type; otherwise, false.</returns>
     public bool TryGetValidatableTypeInfo(Type type, [NotNullWhen(true)] out ValidatableTypeInfo? validatableTypeInfo)
     {
         foreach (var resolver in Resolvers)
@@ -26,6 +50,13 @@ public bool TryGetValidatableTypeInfo(Type type, [NotNullWhen(true)] out Validat
         return false;
     }
 
+    /// <summary>
+    /// Attempts to get validation information for the specified parameter.
+    /// </summary>
+    /// <param name="parameterInfo">The parameter to get validation information for.</param>
+    /// <param name="validatableParameterInfo">When this method returns, contains the validation information for the specified parameter,
+    /// if validation information was found; otherwise, null.</param>
+    /// <returns>true if validation information was found for the specified parameter; otherwise, false.</returns>
     public bool TryGetValidatableParameterInfo(ParameterInfo parameterInfo, [NotNullWhen(true)] out ValidatableParameterInfo? validatableParameterInfo)
     {
         foreach (var resolver in Resolvers)