Add support for OpenAPI 3.2

[martincostello]

Update to Microsoft.OpenApi 3.x and add support for OpenAPI 3.2 document generation.

Depends on swagger-api/swagger-ui#10575 for swagger-ui and Redocly/redoc#2746 for Redoc, otherwise users won't be able to actually render OpenAPI 3.2 documents in the UIs we bundle.

TODO

• Add verify tests for OpenAPI 3.2 documents
• Write migration guide
• Update README version table
• Manual testing
  • Test that the generated schemas are valid
  • Test that swagger-ui renders OpenAPI 3.2 documents (needs Support OpenAPI 3.2 swagger-api/swagger-ui#10575)
  • Test that Redoc renders OpenAPI 3.2 documents (needs Support OpenAPI 3.2 documents Redocly/redoc#2746)

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 94.92%. Comparing base (04320c3) to head (5c5cd61).
⚠️ Report is 111 commits behind head on master.

Additional details and impacted files

@@           Coverage Diff           @@
##           master    #3646   +/-   ##
=======================================
  Coverage   94.92%   94.92%           
=======================================
  Files         111      111           
  Lines        3885     3885           
  Branches      783      783           
=======================================
  Hits         3688     3688           
  Misses        197      197           

Flag	Coverage Δ
Linux	94.92% <100.00%> (ø)
Windows	94.92% <100.00%> (ø)
macOS	94.92% <100.00%> (ø)

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

☔ View full report in Codecov by Harness.
📢 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.

[github-actions]

This pull request is stale because it has been open for 60 days with no activity. It will be automatically closed in 14 days if no further changes are made.

[github-actions]

This pull request is stale because it has been open for 60 days with no activity. It will be automatically closed in 14 days if no further changes are made.