Need guidance on `ValidatableTypeAttribute` for class library in documentation, or a fix for experimental attribute

[kgar]

Description

I have a class library which needs the ability to specify [ValidatableType] on its models, assuming this is required for nested object validation.

After following the documentation for "Use validation models from a different assembly", I am required to use the "Experimental" attribute and suppress the error with pragma tags. Is this intentional? If so, please update the documentation to specifically instruct that people are required to do this, because it feels like this is an oversight when trying to set up class libraries with the new validation.

With that said, I hope there's some better fix than simply putting pragma tags. Upgrading our class libraries to .net 10 with the new validation did not feel seamless or like an upgrade with the need for pragma tags on all of our classes with nested validation.

Sample:

#pragma warning disable ASP0029 // dotnet 10 release notes instruct to use this attribute for nested type validation.
[Microsoft.Extensions.Validation.ValidatableType]
#pragma warning restore ASP0029 // dotnet 10 release notes instruct to use this attribute for nested type validation.
public class MyExampleParentClass {
    public class MyExampleChildClass { get; set; }
}

public class MyExampleChildClass {
    [Required]
    public string? ExampleString { get; set; }
}

Page URL

https://learn.microsoft.com/en-us/aspnet/core/blazor/forms/validation?view=aspnetcore-10.0

Content source URL

https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/blazor/forms/validation.md

Document ID

bcb470e1-c859-0549-b4ef-c6c9b7ef2c72

Platform Id

b4c1bad9-fc7a-21f5-2552-f0f3617f77db

Article author

@guardrex

Metadata

• ID: bcb470e1-c859-0549-b4ef-c6c9b7ef2c72
• PlatformId: b4c1bad9-fc7a-21f5-2552-f0f3617f77db
• Service: aspnet-core
• Sub-service: blazor

Related Issues

[github-actions]

🦃 Happy Thanksgiving! 🍽️

Stand-by! A green dinosaur 🦖 will be along shortly to assist.

[guardrex]

@oroztocil ... Do you have a minute to take a look at this?

Hello @kgar ... Hummmm 🤔 ... The only discussion that I'm aware of (and that led to some docs work along these lines) was per ...

dotnet/aspnetcore#63626

... which led to a docs PR, which was merged for the 10.0 release ...

https://github.com/dotnet/AspNetCore.Docs/pull/36246/files

... and that had nothing related to having a pragma warning or Experimental attribute.

Stand-by for a bit until Ondřej arrives here to take a look at this. If this is something that the product unit should be looking at, this issue might get moved to their repo.

[davhdavh]

Similar, it says to use [SkipValidation], but that causes an error with error CS0104: 'ValidatableType' is an ambiguous reference between 'Microsoft.Extensions.Validation.Embedded.ValidatableTypeAttribute' and 'Microsoft.Extensions.Validation.ValidatableTypeAttribute'

[guardrex]

There might be a delay here while engineers went OOF after the .NET 10 release. If you want, you can open an issue on the product unit's repo for this at ...

https://github.com/dotnet/aspnetcore/issues

If you do, please add ...

cc: @guardrex https://github.com/dotnet/AspNetCore.Docs/issues/36363

... to the bottom of your opening comment to cross-link this docs issue and ping me on it.