search

dotnet / aspnetcore

ASP.NET Core is a cross-platform .NET framework for building modern cloud-based web applications on Windows, Mac, or Linux.
https://asp.net
MIT License
35.35k stars 9.99k forks source link

Docs: Improving Troubleshooting guide for IIS/ANCM #26518

Closed jkotalik closed 3 years ago

jkotalik commented 4 years ago

ANCM docs are some of the most viewed docs for all of ASP.NET Core. The Host ASP.NET Core on Window with IIS is the second most viewed document, and Troubleshoot ASP.NET Core on Azure App Service and IIS is our sixth most viewed document.

It seems like the trouble shooting document isn't effectively fixing people's problems for IIS and ANCM. There is a bounce rate of ~28% and a high exit rate of 72%, which is much higher than many other documents. Therefore, I believe a rewrite/restructure of the IIS docs will help a ton with reducing customer issues.

I'd like to make more of a troubleshooting doc that is step by step rather than a reference. Something in the vein of https://docs.microsoft.com/en-us/aspnet/core/signalr/diagnostics?view=aspnetcore-3.1, showing what needs to be enabled for debugging and what each part means.

jkotalik commented 3 years ago

Chatted with @Rick-Anderson about this over email, apparently this doc is one of the most effective for all ASP.NET Core docs. the CSAT score is significantly higher than other docs. Let's not rock the boat here until we have more concrete evidence besides just bounce rate.