search

dotnet / dotnet-api-docs

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

Applies to & new values #1026

Open BrendanGrant opened 5 years ago

BrendanGrant commented 5 years ago

By default when visiting this page a user is shown the version that relates to the latest version of the .net framework (4.7.2), which is the first version to include EphemeralKeySet. This is a bit confusing as the "Applies to" section calls out frameworks going back quite some time.

Given the newness of this enum value, it might be helpful to call out the new/exception case, as anyone not developing against 4.7.2 may be confused as to why they do not see it when developing.

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

mairaw commented 5 years ago

Thank you for feedback @BrendanGrant. The Applies to in the enum pages refers to the enum class as a whole. If you change the version filters, you get the appropriate values for that version. But we could call out in the text when that value was introduced as well.