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

Documentation issue

Open johnsone006 opened this issue 9 months ago • 1 comments

I wish that when possible, the Microsoft learn website would always include examples of how objects from classes are used. For example, the AsycContentLoadedEventArgs class. The class page itself has a snippet that shows what class it inherits, but that's it. And the method pages just include snippets that declare the method header with the parameters but not how those parameters are actually instantiated.

johnsone006 avatar May 04 '24 02:05 johnsone006

I couldn't figure out the best area label to add to this issue. If you have write-permissions please help me learn by adding exactly one area label.

Hello @johnsone006 - Do you have a link to the page you were looking for so we can take a look at the code example?

carlossanlop avatar May 07 '24 17:05 carlossanlop

This issue has been marked needs-author-action and may be missing some important information.

Hello @johnsone006 - Do you have a link to the page you were looking for so we can take a look at the code example?

Yep. Here: https://learn.microsoft.com/en-us/dotnet/api/system.windows.automation.asynccontentloadedeventargs?view=windowsdesktop-8.0 Here: https://learn.microsoft.com/en-us/dotnet/api/system.windows.automation.asynccontentloadedeventargs.asynccontentloadedstate?view=windowsdesktop-8.0#system-windows-automation-asynccontentloadedeventargs-asynccontentloadedstate

And here: https://learn.microsoft.com/en-us/dotnet/api/system.windows.automation.asynccontentloadedeventargs.percentcomplete?view=windowsdesktop-8.0#system-windows-automation-asynccontentloadedeventargs-percentcomplete

johnsone006 avatar May 10 '24 19:05 johnsone006

Like to give an example of an event that's much better documented: https://learn.microsoft.com/en-us/dotnet/api/system.windows.automation.invokepattern.invokedevent?view=windowsdesktop-8.0#system-windows-automation-invokepattern-invokedevent It would be nice to see how the async content loaded event would be subscribed to and what the event handler method might look like.

johnsone006 avatar May 12 '24 20:05 johnsone006