[chore]: separate docs previews from production publishing
Merged
SE
2mo ago+132+132+012345678901234567890123456789-2-2-0123456789
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
mainand a persistent preview updated by docs pushes tomain. 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
mainand persistent previews for docs pushes tomain, 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.