Skip to content

NO-JIRA: Test docs deploy preview #8492

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
bryan-cox wants to merge 2 commits into from
+5 −1
Closed

NO-JIRA: Test docs deploy preview #8492

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
d320c67
docs: clarify docs preview cleanup behavior
bryan-cox May 12, 2026
b932a2e
docs: add troubleshooting section to docs preview page
bryan-cox May 12, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion docs/content/how-to/ci/docs-preview.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ The preview system uses two separate workflows for security, following the reusa

GitHub shows a **View deployment** link in the PR timeline via the `docs-preview` environment.

The preview is available at `https://pr-<number>.hypershift.pages.dev`.
The preview is available at `https://pr-<number>.hypershift.pages.dev`. Previews are automatically cleaned up by Cloudflare's branch retention policy.

## Configuration

Expand All @@ -24,6 +24,10 @@ The deploy workflow requires two secrets configured on the `docs-preview` GitHub
| `CLOUDFLARE_ACCOUNT_ID` | Cloudflare account ID |
| `CLOUDFLARE_API_TOKEN` | API token with Cloudflare Pages edit permissions |

## Troubleshooting

If the preview link doesn't appear on your PR, check that the Docs Build workflow completed successfully. The Docs Deploy workflow triggers automatically after a successful build.

## Local Preview

To preview documentation locally:
Expand Down
Loading