feat: use openapi.json by default

[fourcels]

openapi.json can directly view in browser

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 92.56%. Comparing base (4fd3cdb) to head (e8e7784).
⚠️ Report is 33 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #872   +/-   ##
=======================================
  Coverage   92.56%   92.56%           
=======================================
  Files          23       23           
  Lines        5511     5511           
=======================================
  Hits         5101     5101           
  Misses        351      351           
  Partials       59       59           

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

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[danielgtaylor]

@fourcels why do you want this change? The doc generator supports YAML just fine.

[wolveix]

Hey @fourcels! I'm going to close this as I'm not sure there's any reason to switch from YAML as the default, particularly considering that both are served anyway and YAML is the standard for OpenAPI specifications.