search

dotnet / dotnet-api-docs

.NET API reference documentation (.NET 5+, .NET Core, .NET Framework)
https://docs.microsoft.com/dotnet/api/
Other
725 stars 1.56k forks source link

FrozenDictionary<TKey,TValue> documentation: lists support for .NET 6 and .NET 7 but it was first available in .NET 8 #10591

Closed udlose closed 1 week ago

udlose commented 1 week ago

Describe the issue or suggestion

Per FrozenDictionary<TKey,TValue> Class - Applies To section, the versions listed that have FrozenDictionary are listed as .NET 6, 7, 8, 9.

FrozenDictionary does not exist in .NET 6 or .NET 7. Please update the docs.

Image

dotnet-policy-service[bot] commented 1 week ago

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

eiriktsarpalis commented 1 week ago

FYI @gewarren @BillWagner. We seen to be getting multiple customer reports about this being an issue.

gewarren commented 1 week ago

@eiriktsarpalis This is definitely a problem and confusing for customers (I see lots of feedback about this through the "black box" UUF feedback channel as well). We previously had completely separate ".NET platform extensions" monikers that we removed in favor of showing the .NET versions that the down-level packages are compatible with. We did that in part because that's how apisof.net shows the applicable versions:

Image

The problem for the API reference docs on learn.microsoft.com is that the Applies to table doesn't differentiate between package-provided and in-box versions. If we were to split out the Applies to table like this mock-up from an internal work item, would that help? Or do you have any other ideas on how to resolve this?

Image

cc @nickwalkmsft

gewarren commented 1 week ago

I'm going to close this as a duplicate of https://github.com/dotnet/dotnet-api-docs/issues/10012. Please leave any further feedback or ideas there.