search

dotnet / dotnet-api-docs

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

System.Security.Cryptography documentation flaw #9930

Open Fantasista766 opened 1 month ago

Fantasista766 commented 1 month ago

There is no any mention about sub namespaces on the page

https://learn.microsoft.com/ru-ru/dotnet/api/system.security.cryptography?view=net-8.0

As I understood there are 4 sub namespaces for System.Security.Cryptography:

System.Security.Cryptography.Cose System.Security.Cryptography.Pkcs System.Security.Cryptography.X509Certificates System.Security.Cryptography.Xml

It is useful to add corresponding links to the page with System.Security.Cryptography for better user experience

gewarren commented 1 month ago

FYI @mtrilbybassett.

colejohnson66 commented 1 month ago

Child namespaces are not documented on the API browser. You need to look elsewhere to find them. I, personally, would like to see that changed; There's no discoverability.