OpenAPI's AOT support is mentioned for a too-wide range of framework versions

[sander1095]

Description

The document mentions that AOT support has been present in .NET 9, which is correct! However, this is also rendered for .NET 8, .NET 7 and .NET 6, which is incorrect, at least in terms of % compatibleness.

The document needs to be updated to showcase .NET 9's (full?) AOT support.

I also believe that, as .NET 8 is LTS, it should also be updated to reflect what is and is NOT compatible and refer people to .NET 9 for full AOT support. This way readers get a nice "side-by-side" between changes, which can be beneficial in cases where they stumble onto AOT issues but might not want to upgrade to .NET 9 for reasons.

Furthermore, the document needs investigation about its claims for OpenAPI AOT support for .NET 6 and .NET 7. If this is not true, it should be removed from the document.

Page URL

https://learn.microsoft.com/en-us/aspnet/core/fundamentals/openapi/aspnetcore-openapi?view=aspnetcore-8.0&tabs=visual-studio#trimming-and-native-aot

Content source URL

https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/fundamentals/openapi/aspnetcore-openapi.md

Document ID

27bad30c-e0b4-10fb-b202-a29d4f8fad24

Article author

@captainsafia

Metadata

• ID: 27bad30c-e0b4-10fb-b202-a29d4f8fad24
• Service: aspnet-core
• Sub-service: fundamentals

Related Issues