Initial draft of diagnostic redesign

[adegeo]

Summary

Going to need help with wording.

Fixes #3143
Fixes #3142
Fixes #3141
Fixes #3140
Fixes #3139
Fixes #3131
Fixes #3126
Fixes #3057
Fixes #1658

TODO:

• Add the missing code examples.
• Sort the issue with linking to a bookmark in the overview.
• File a PR with the product that changes the diagnostic links to the direct files. Adjust URLs used for diagnostic/analyzer help aspire#8936
• Update the overview article and move the suppress instructions to the core .NET article.

---

Internal previews

📄 File	🔗 Preview link
docs/diagnostics/aspire006.md	docs/diagnostics/aspire006
docs/diagnostics/aspireacadomains001.md	docs/diagnostics/aspireacadomains001
docs/diagnostics/aspireazure001.md	docs/diagnostics/aspireazure001
docs/diagnostics/aspirecosmosdb001.md	docs/diagnostics/aspirecosmosdb001
docs/diagnostics/aspirehostingpython001.md	docs/diagnostics/aspirehostingpython001
docs/diagnostics/aspirepublishers001.md	docs/diagnostics/aspirepublishers001
docs/diagnostics/overview.md	docs/diagnostics/overview
docs/fundamentals/orchestrate-resources.md	docs/fundamentals/orchestrate-resources
docs/get-started/build-aspire-apps-with-python.md	docs/get-started/build-aspire-apps-with-python
docs/toc.yml	docs/toc

[adegeo]

@IEvangelist This is ready. I may need to adjust the category names and any invalid wording I'm using due to lack of knowledge.

[IEvangelist]

I like it a lot, well done! I do want @davidfowl, @eerhardt, and @mitchdenny to see this and provide feedback.

[IEvangelist]

Where does all of this content move to? Maybe just create a new file with this under the Overview and put this suppression stuff in there?

[adegeo]

I copied it out and I'll update the .NET docs with the information.

[mitchdenny]

I like splitting this out too. Can we confirm that the URLs given by the analyzers will still get people to the right place?