Mark validations info related types are experimental

Author: captainsafia

docs/list-of-diagnostics.md

@@ -34,6 +34,7 @@
 |  __`ASP0026`__ | [Authorize] overridden by [AllowAnonymous] from farther away |
 |  __`ASP0027`__ | Unnecessary public Program class declaration |
 |  __`ASP0028`__ | Consider using ListenAnyIP() instead of Listen(IPAddress.Any) |
+|  __`ASP0029`__ | Experimental warning for validations resolver APIs |
 
 ### API (`API1000-API1003`)
 

src/Http/Http.Abstractions/src/Validation/IValidatableInfo.cs

@@ -1,11 +1,14 @@
 // Licensed to the .NET Foundation under one or more agreements.
 // The .NET Foundation licenses this file to you under the MIT license.
 
+using System.Diagnostics.CodeAnalysis;
+
 namespace Microsoft.AspNetCore.Http.Validation;
 
 /// <summary>
 /// Represents an interface for validating a value.
 /// </summary>
+[Experimental("ASP0029", UrlFormat = "https://aka.ms/aspnet/analyzer/{0}")]
 public interface IValidatableInfo
 {
     /// <summary>

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

@@ -10,6 +10,7 @@ namespace Microsoft.AspNetCore.Http.Validation;
 /// Provides an interface for resolving the validation information associated
 /// with a given <seealso cref="Type"/> or <seealso cref="ParameterInfo"/>.
 /// </summary>
+[Experimental("ASP0029", UrlFormat = "https://aka.ms/aspnet/analyzer/{0}")]
 public interface IValidatableInfoResolver
 {
     /// <summary>

src/Http/Http.Abstractions/src/Validation/RuntimeValidatableParameterInfoResolver.cs

@@ -1,3 +1,5 @@
+#pragma warning disable ASP0029 // Type is for evaluation purposes only and is subject to change or removal in future updates. Suppress this diagnostic to proceed.
+
 // Licensed to the .NET Foundation under one or more agreements.
 // The .NET Foundation licenses this file to you under the MIT license.
 

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

@@ -4,12 +4,14 @@
 using System.Collections;
 using System.ComponentModel.DataAnnotations;
 using System.Diagnostics;
+using System.Diagnostics.CodeAnalysis;
 
 namespace Microsoft.AspNetCore.Http.Validation;
 
 /// <summary>
 /// Contains validation information for a parameter.
 /// </summary>
+[Experimental("ASP0029", UrlFormat = "https://aka.ms/aspnet/analyzer/{0}")]
 public abstract class ValidatableParameterInfo : IValidatableInfo
 {
     private RequiredAttribute? _requiredAttribute;

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

@@ -10,6 +10,7 @@ namespace Microsoft.AspNetCore.Http.Validation;
 /// <summary>
 /// Contains validation information for a member of a type.
 /// </summary>
+[Experimental("ASP0029", UrlFormat = "https://aka.ms/aspnet/analyzer/{0}")]
 public abstract class ValidatablePropertyInfo : IValidatableInfo
 {
     private RequiredAttribute? _requiredAttribute;

src/Http/Http.Abstractions/src/Validation/ValidatableTypeAttribute.cs

@@ -1,13 +1,16 @@
 // Licensed to the .NET Foundation under one or more agreements.
 // The .NET Foundation licenses this file to you under the MIT license.
 
+using System.Diagnostics.CodeAnalysis;
+
 namespace Microsoft.AspNetCore.Http.Validation;
 
 /// <summary>
 /// Indicates that a type is validatable to support discovery by the
 /// validations generator.
 /// </summary>
 [AttributeUsage(AttributeTargets.Class)]
+[Experimental("ASP0029", UrlFormat = "https://aka.ms/aspnet/analyzer/{0}")]
 public sealed class ValidatableTypeAttribute : Attribute
 {
 }

src/Http/Http.Abstractions/src/Validation/ValidatableTypeInfo.cs

@@ -11,6 +11,7 @@ namespace Microsoft.AspNetCore.Http.Validation;
 /// <summary>
 /// Contains validation information for a type.
 /// </summary>
+[Experimental("ASP0029", UrlFormat = "https://aka.ms/aspnet/analyzer/{0}")]
 public abstract class ValidatableTypeInfo : IValidatableInfo
 {
     private readonly int _membersCount;

src/Http/Http.Abstractions/src/Validation/ValidateContext.cs

@@ -2,12 +2,14 @@
 // The .NET Foundation licenses this file to you under the MIT license.
 
 using System.ComponentModel.DataAnnotations;
+using System.Diagnostics.CodeAnalysis;
 
 namespace Microsoft.AspNetCore.Http.Validation;
 
 /// <summary>
 /// Represents the context for validating a validatable object.
 /// </summary>
+[Experimental("ASP0029", UrlFormat = "https://aka.ms/aspnet/analyzer/{0}")]
 public sealed class ValidateContext
 {
     /// <summary>

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

@@ -19,6 +19,7 @@ public class ValidationOptions
     /// Source-generated resolvers are typically inserted at the beginning of this list
     /// to ensure they are checked before any runtime-based resolvers.
     /// </remarks>
+    [Experimental("ASP0029", UrlFormat = "https://aka.ms/aspnet/analyzer/{0}")]
     public IList<IValidatableInfoResolver> Resolvers { get; } = [];
 
     /// <summary>
@@ -35,6 +36,7 @@ public class ValidationOptions
     /// <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>
+    [Experimental("ASP0029", UrlFormat = "https://aka.ms/aspnet/analyzer/{0}")]
     public bool TryGetValidatableTypeInfo(Type type, [NotNullWhen(true)] out IValidatableInfo? validatableTypeInfo)
     {
         foreach (var resolver in Resolvers)
@@ -56,6 +58,7 @@ public bool TryGetValidatableTypeInfo(Type type, [NotNullWhen(true)] out IValida
     /// <param name="validatableInfo">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>
+    [Experimental("ASP0029", UrlFormat = "https://aka.ms/aspnet/analyzer/{0}")]
     public bool TryGetValidatableParameterInfo(ParameterInfo parameterInfo, [NotNullWhen(true)] out IValidatableInfo? validatableInfo)
     {
         foreach (var resolver in Resolvers)