AspNetCore.Docs icon indicating copy to clipboard operation
AspNetCore.Docs copied to clipboard

Freshness Opportunities - Ongoing

Open cmastr opened this issue 5 months ago β€’ 8 comments

The following files should be reviewed for freshness and updated, if needed. Each item has more than 10k page views per month:


Associated WorkItem - 475914

cmastr avatar Jul 17 '25 15:07 cmastr

/aspnet/core/getting-started/index.md is covered separately by https://github.com/dotnet/AspNetCore.Docs/issues/35740 and assigned to me πŸ¦–. I should be able to reach it next week ... within two weeks for sure.

guardrex avatar Jul 17 '25 16:07 guardrex

@cmastr hey there, as you are listing the authentication and security pages, could someone check on this here also?

the asp net core docs are sort of covering authentication, but the RemoteAuthenticationHandler which is told to be usable for oAuth2, is not mentioned anywhere in those docs. after 3 Days I finally found these docs here: https://learn.microsoft.com/en-us/aspnet/web-api/overview/security/external-authentication-services but as you can see, that is reffering to asp net core 4.x => not current

As you hopefully will agree with me, this topic and also the CORS topic I found there better visualized, but also kind of that whole section this both is nested in "Authorization Authentication Security" would be absolutly awesome if we could get this enhanced, broken down, visualized, but also abstracted shown, in the CURRENT Asp Net core docs πŸš€ the ones we have on the aspnet/core url are a lot guiding and redirecting to ms identity and azure, which might be a good way to go, but I as beginner would prefer to learn the fundamentals like there at first and then you can still tell and link us to that other product. but that would really help a lot to get a better entrance! ❀️

DevTKSS avatar Jul 18 '25 17:07 DevTKSS

great finding: https://www.reddit.com/r/dotnet/comments/we9qx8/a_comprehensive_overview_of_authentication_in/ do you see any chance to somehow implement this? would be a great resource for learning!

DevTKSS avatar Jul 19 '25 12:07 DevTKSS

@cmastr would have a page to add to your list to update, if you dont mind πŸ‘ filed the (until now) discovered discrepancys in here #35783 #35782 so you can see whats missing πŸš€

DevTKSS avatar Jul 20 '25 12:07 DevTKSS

@DevTKSS, thanks, those are also great topics for us to update. If you create an issue for it right at the doc, it gets tracked with the context of the issue and issue history. If you would rather not create new issues on the topic itself that you suggested, I can do that for you. Great information and the feedback is very appreciated. Thanks!

This particular issue here is scoped to a small set of topics that were getting over 10K page views per month that we were trying to squeeze on top of a large workload already set for July (for which there are just a few days left). The topics you were pointing out are important, but out of scope for this issue (such as ~700 page views a month as opposed to 10,000). We will still address them, it is just that this is the wrong issue to track them.

wadepickett avatar Jul 28 '25 22:07 wadepickett

@wadepickett I did create those linked issues via the bottom button on the pages, just it seems to be not in interest of that team, might be caused from that person is not longer at ms 🀷 or as the addoAuth( method i was trying to use with its challenge method (guessing that should be included in a doc to this api because it would be just useless to have something requiring a pkce but no challenge πŸ˜…) seems to only has api docs, yes with that its kind of not even possible to add an issue on this particular doc page instead ;) And yeah sorry that my (seems like) hopeless search for the solution of a da** oAuth flow got not ~300 or more clicks countπŸ˜… I was assuming that something like a pkce flow and oAuth would be kind of the base before someone uses a oidc auth🀣 maybe I am blind but all I found is oidc to google, fb and so on. Nothing like that simple thing.

DevTKSS avatar Jul 28 '25 23:07 DevTKSS

@cmastr would have a page to add to your list to update, if you dont mind πŸ‘ filed the (until now) discovered discrepancys in here #35783 #35782 so you can see whats missing πŸš€

We'll take a look at these and get them prioritized. Thanks so much for the contribution!

cmastr avatar Aug 07 '25 14:08 cmastr

Good progress on this item!

cmastr avatar Sep 12 '25 17:09 cmastr