Skip to content

feat: use stable preview URLs and skip draft PRs#102

Open
fern-support wants to merge 1 commit intomainfrom
devin/1773082329-stable-preview-urls
Open

feat: use stable preview URLs and skip draft PRs#102
fern-support wants to merge 1 commit intomainfrom
devin/1773082329-stable-preview-urls

Conversation

@fern-support
Copy link
Contributor

feat: use stable preview URLs and skip draft PRs

Summary

Part of a cross-repo feature to make docs preview URLs stable across PR commits (see fern#10575).

Two changes to the preview-docs workflow:

  1. Stable preview URLs: Passes --preview-id with the PR number so every commit in the same PR reuses the same preview domain instead of generating a new one.
  2. Skip draft PRs: Adds if: github.event.pull_request.draft == false to avoid wasting preview generations on draft PRs.

⚠️ Depends on companion PRs being merged and released first:

  • fern-platform (server): accepts previewId and derives a deterministic domain
  • fern CLI: adds --preview-id flag support

Review & Testing Checklist for Human

  • Deployment order: This workflow will fail if merged before the Fern CLI release that supports --preview-id. Confirm the CLI change is released before merging.
  • Verify the draft PR skip condition (github.event.pull_request.draft == false) behaves correctly — note that PRs marked as "ready for review" after being draft will re-trigger the workflow.
  • End-to-end test: open a PR against a repo using this workflow template, push two commits, and confirm both produce the same preview URL in the PR comment.

Notes

Pass --preview-id with the PR number so all commits in a PR share the
same preview URL. Skip preview generation for draft PRs.

Co-Authored-By: blank <blank@buildwithfern.com>
@devin-ai-integration
Copy link
Contributor

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant