Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

inherited Properties missing for DirectoryInfo and FileSystemInfo #10815

Open
DickBaker opened this issue Jan 7, 2025 · 3 comments
Open

inherited Properties missing for DirectoryInfo and FileSystemInfo #10815

DickBaker opened this issue Jan 7, 2025 · 3 comments
Labels
area-System.IO docs-experience Indicates issues that are about the learn.microsoft.com experience or design untriaged New issue has not been triaged by the area owner

Comments

@DickBaker
Copy link
Contributor

Type of issue

Missing information

Description

although DirectoryInfo and FileSystemInfo document each property at their parent levels [right column]
https://learn.microsoft.com/en-us/dotnet/api/system.io.directoryinfo?view=net-9.0
https://learn.microsoft.com/en-us/dotnet/api/system.io.fileinfo?view=net-9.0
c/w links to the parent FileSystemInfo, but these are not included in the respective left-hand Properties menu

agreed that devs should be able to navigate up the trees, but IMHO the docs should aspire to completeness and convenience
as directory/file activity is so intrinsic to every devs' life, reasonable to make easy to discover [happily collapsed until needed]

Likewise the Methods that are inherited from FileSystemInfo are omitted, and should be explicitly listed [in left column].

Page URL

https://learn.microsoft.com/en-us/dotnet/api/system.io.directoryinfo?view=net-9.0

Content source URL

https://github.com/dotnet/dotnet-api-docs/blob/main/xml/System.IO/DirectoryInfo.xml

Document Version Independent Id

1e082b3e-0d02-f6f0-90bb-5de3980b07fe

Article author

@dotnet-bot

@dotnet-policy-service dotnet-policy-service bot added the untriaged New issue has not been triaged by the area owner label Jan 7, 2025
Copy link
Contributor

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

@adamsitnik
Copy link
Member

@gewarren what is our policy for listing methods inherited from the base types?

@gewarren
Copy link
Contributor

gewarren commented Jan 8, 2025

@DickBaker I think you are asking for inherited APIs to be listed in the table of contents on the LHS, is that correct? It's by design that they're not, presumably for brevity. Tagging @nickwalkmsft @mtrilbybassett with this site experience feedback.

@gewarren gewarren added the docs-experience Indicates issues that are about the learn.microsoft.com experience or design label Jan 8, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area-System.IO docs-experience Indicates issues that are about the learn.microsoft.com experience or design untriaged New issue has not been triaged by the area owner
Projects
None yet
Development

No branches or pull requests

3 participants