From d320c676f8692f5070228543ee2494404ce619f5 Mon Sep 17 00:00:00 2001 From: Bryan Cox Date: Tue, 12 May 2026 09:59:06 -0400 Subject: [PATCH 1/2] docs: clarify docs preview cleanup behavior Co-Authored-By: Claude Opus 4.6 --- docs/content/how-to/ci/docs-preview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/content/how-to/ci/docs-preview.md b/docs/content/how-to/ci/docs-preview.md index 0a82bc70de5..dadd5af88ae 100644 --- a/docs/content/how-to/ci/docs-preview.md +++ b/docs/content/how-to/ci/docs-preview.md @@ -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-.hypershift.pages.dev`. +The preview is available at `https://pr-.hypershift.pages.dev`. Previews are automatically cleaned up by Cloudflare's branch retention policy. ## Configuration From b932a2e014e2bdd2ab9eb9761b752285b1a27a93 Mon Sep 17 00:00:00 2001 From: Bryan Cox Date: Tue, 12 May 2026 10:04:47 -0400 Subject: [PATCH 2/2] docs: add troubleshooting section to docs preview page Co-Authored-By: Claude Opus 4.6 --- docs/content/how-to/ci/docs-preview.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/content/how-to/ci/docs-preview.md b/docs/content/how-to/ci/docs-preview.md index dadd5af88ae..7758adfad15 100644 --- a/docs/content/how-to/ci/docs-preview.md +++ b/docs/content/how-to/ci/docs-preview.md @@ -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: