Update documentation for v10 and OpenAPI 3.1

[martincostello]

• Update documentation for v10.
• Add code snippets for all samples to validate compilation (not function).
• Add migration guide from v9 to v10.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 94.75%. Comparing base (6cad31d) to head (a64d7a9).
⚠️ Report is 1 commits behind head on dotnet-vnext.
✅ All tests successful. No failed tests found.

Additional details and impacted files

@@              Coverage Diff              @@
##           dotnet-vnext    #3585   +/-   ##
=============================================
  Coverage         94.75%   94.75%           
=============================================
  Files               110      110           
  Lines              3830     3830           
  Branches            759      759           
=============================================
  Hits               3629     3629           
  Misses              201      201           

Flag	Coverage Δ
Linux	94.75% <ø> (ø)
Windows	94.75% <ø> (ø)
macOS	?

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[Copilot]

Pull Request Overview

Updates documentation for Swashbuckle.AspNetCore v10 and adds support for OpenAPI 3.1, including a comprehensive migration guide and code snippets for validation.

• Updates all documentation to reflect v10 changes and OpenAPI 3.1 support
• Adds extensive code snippets in a new test project for documentation validation
• Creates migration guide explaining breaking changes from v9 to v10

Reviewed Changes

Copilot reviewed 43 out of 43 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
test/WebSites/DocumentationSnippets/	New test project with code snippets for documentation validation
docs/migrating-to-v10.md	New migration guide from v9 to v10
docs/*.md	Updated documentation files with code snippet references and v10 content
README.md	Updated main documentation with v10 compatibility table and snippet integration
.github/workflows/update-documentation.yml	New GitHub workflow for automated documentation updates
.config/dotnet-tools.json	Added markdown snippets tool for documentation maintenance
mdsnippets.json	Configuration for markdown snippets processing

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}