Document new `ExceptionHandlerOptions.SuppressDiagnosticsCallback` setting -- part 1 moniker version include files

[JamesNK]

[EDIT by guardrex to add the metadata. Note @JamesNK ... If you open the issue from the bottom of the target article with the Open a documentation issue link, the metadata and author ping is automatic.]

ExceptionHandlerOptions.SuppressDiagnosticsCallback is a new setting added in .NET 10.

More information:

• Update "What's new in ASP.NET Core in .NET 10" for .NET 10 Preview 7 #35824 (comment)
• [Breaking change]: Exception diagnostics are suppressed when IExceptionHandler.TryHandleAsync returns true aspnet/Announcements#524

Documentation can be added under this section: https://learn.microsoft.com/en-nz/aspnet/core/fundamentals/error-handling?view=aspnetcore-9.0#exception-handler-page

---

Document Details

⚠ Do not edit this section. It is required for learn.microsoft.com ➟ GitHub issue linking.

• ID: 0e03fdf4-b19b-17c3-04f4-336ab6d2ee06
• Version Independent ID: 38515dfb-91a5-b395-db9d-084bbaf095c8
• Platform ID: c1f85027-4da3-44d1-3171-d49c58a44c78
• Content: Handle errors in ASP.NET Core
• Content Source: aspnetcore/fundamentals/error-handling.md
• Service: aspnet-core
• Sub-service: fundamentals
• GitHub Login: @tdykstra
• Microsoft Alias: tdykstra

---

Associated WorkItem - 478062

[wadepickett]

Triage: CC: @tdykstra

[tdykstra]

moniker versions

The article file itself is for 9 and later
Our latest include file is for 8
So we need a new include file for 9; create it by copying and pasting the current content of the main article file into an include and set the new include file's moniker range to 9
Finally, change the main file moniker range to 10 and later
(don't change the file level moniker range in the metadata at the top of the main article file)
Get your changes into a pull request and get the pull request merged.
After all this prep work you can start on the actual code changes and text changes for the new feature.

Where to put changes for the new feature

• The best location might be https://learn.microsoft.com/en-nz/aspnet/core/fundamentals/error-handling?view=aspnetcore-9.0#iexceptionhandler Here you can put sample code and text that explains it, just make sure you understand how everything works by looking at the breaking change doc [Breaking change]: Exception diagnostics are suppressed when IExceptionHandler.TryHandleAsync returns true · Issue #524 ·

Review also https://learn.microsoft.com/en-nz/aspnet/core/fundamentals/error-handling?view=aspnetcore-9.0#exception-handler-page as a possible place to put code and/or text about this new feature

For the ## "See also" section
[Breaking change]: Exception diagnostics are suppressed when IExceptionHandler.TryHandleAsync returns true · Issue #524 ·

It would be good to locate a link to the breaking change document

Link from What's New article to the article section(s) modified for this issue.