sentry-dotnet icon indicating copy to clipboard operation
sentry-dotnet copied to clipboard

Improve guidance for ASP.NET Core

Open mattjohnsonpint opened this issue 2 years ago • 0 comments

Problem Statement

The ASP.NET Core documentation page could be much clearer.

So could the samples.

Solution Brainstorm

  • [x] Lead with the current version of ASP.NET Core.
  • [x] Add sections for older versions, either collapsed or in tabs.
  • [x] Reduce the list of features so it doesn't take up so much of the first page.
  • [x] Make sure EnableTracing and UseSentryTracing are visible in all examples.
  • [x] Make sure its clear what order UseSentryTracing goes in the middleware (after UseRouting, but why and what if that's not present?)
  • [ ] Update samples to use the current ASP.NET Core. Start from templates dotnet new web / webapi / mvc, etc.
    • No need to show every feature of Sentry. Just show what's needed to get started in ASP.NET Core.
    • [ ] Sentry.Samples.AspNetCore.Basic
    • [ ] Sentry.Samples.AspNetCore.Blazor.Server
    • [ ] Sentry.Samples.AspNetCore.Blazor.Wasm
    • [ ] Sentry.Samples.AspNetCore.Grpc
    • [x] https://github.com/getsentry/sentry-dotnet/pull/3083
    • [ ] Sentry.Samples.AspNetCore.Serilog
    • [ ] An ASP.NET Core AOT sample - New project template
  • [ ] Add a few limited samples for older versions of ASP.NET Core, but only where drastically different from current.

mattjohnsonpint avatar Mar 30 '23 22:03 mattjohnsonpint