[chore]: separate docs previews from production publishing

Merged
SE
2mo ago
+132-2

why

SDK changes must include documentation, but merging those docs into main should not publish unreleased APIs to the public site

what changed

  • Add Mintlify previews for docs PRs targeting main and a persistent preview updated by docs pushes to main. Report the URL and wait for deployment success.
  • Run docs reference tests and Mintlify validation independently of SDK path filters, including on docs-only PRs and production backports.
  • Include Go SDK source in the docs test cache inputs.
  • Add explicit main-only guards to SDK publishing jobs, including the reusable Python publisher.

Summary by cubic

Separates docs previews from production publishing so unreleased API docs aren't published to the public site.

  • Adds Mintlify previews for docs PRs targeting main and persistent previews for docs pushes to main, reporting the URL and waiting for deployment success.
  • Runs docs reference tests and Mintlify validation on every PR, including docs-only PRs and backports.
  • Includes Go SDK source in the docs test cache inputs.
  • Adds main-only guards to SDK publishing jobs.