dotnet-api-docs icon indicating copy to clipboard operation
dotnet-api-docs copied to clipboard

"Applies to" table incorrect for new feature(s)?

Open ianleeder opened this issue 1 year ago • 1 comments

I'm looking at JsonSerialisation options, specifically the IndentSize property.

I have clearly selected .NET 8, the "Applies to" table specifies that it's applicable to .NET 8, however it is not. The only hint in the documentation is the package version: image

Checking the source code for this class, I can see that the IndentSize property is available in the branch release/9.0-preview5 but it is not in release/8.0.

I haven't checked the documentation for any other new properties added in 9.0-preview.

ianleeder avatar Jun 25 '24 03:06 ianleeder

Tagging subscribers to this area: @dotnet/area-system-runtime

Thank you for the feedback. The NuGet package is compatible with down-level versions, which is why the older versions are shown in the Applies to table. But we've also received a lot of feedback that this is too confusing. We have a design change in the works to hopefully make this less confusing. Closing as duplicate of #10012.

gewarren avatar Oct 19 '24 00:10 gewarren