# 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.

<!-- This is an auto-generated description by cubic. -->
---
## 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.

<sup>Written for commit 6fd167a181e565cebdcef330515d6e884dfad0d1.
Summary will update on new commits.</sup>

<a
href="https://cubic.dev/pr/browserbase/stagehand/pull/3042?utm_source=github"
target="_blank" rel="noopener noreferrer"
data-no-image-dialog="true"><picture><source
media="(prefers-color-scheme: dark)"
srcset="https://www.cubic.dev/buttons/review-in-cubic-dark.svg"><source
media="(prefers-color-scheme: light)"
srcset="https://www.cubic.dev/buttons/review-in-cubic-light.svg"><img
alt="Review in cubic"
src="https://www.cubic.dev/buttons/review-in-cubic-dark.svg"></picture></a>

<!-- End of auto-generated description by cubic. -->