From 0d0d2cc4678353336d9d12b879024c9e637eec7e Mon Sep 17 00:00:00 2001 From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Date: Fri, 12 Jun 2026 14:14:55 +0000 Subject: [PATCH 1/2] docs: add preview link guidance to fern-docs skill Co-Authored-By: Danny Sheridan --- skills/fern-docs/SKILL.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/skills/fern-docs/SKILL.md b/skills/fern-docs/SKILL.md index 0c6c5e0..f97179e 100644 --- a/skills/fern-docs/SKILL.md +++ b/skills/fern-docs/SKILL.md @@ -142,3 +142,18 @@ just new pages. decides A; Y decides B"), not that they share a config key or sit in the same directory. If the only thing linking two features is the same YAML key, it's not worth a cross-reference. + +## Preview links + +After pushing a PR in a Fern docs repo, a GitHub Actions bot posts a comment with +preview URLs. **Always get preview links from this PR comment** — don't construct +them manually or guess the format. + +The bot comment contains: + +- A general preview link for the site root. +- Specific links for each page you changed, listed under "markdown pages you've + updated." + +When sharing a preview with the user, use the specific page link(s) so they land +directly on the changed content. From dfdbd8f34b5346994289de89f9c45a1ff2e97b39 Mon Sep 17 00:00:00 2001 From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Date: Fri, 12 Jun 2026 14:18:39 +0000 Subject: [PATCH 2/2] docs: add fallback guidance for outdated preview workflow Co-Authored-By: Danny Sheridan --- skills/fern-docs/SKILL.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/skills/fern-docs/SKILL.md b/skills/fern-docs/SKILL.md index f97179e..9a991ce 100644 --- a/skills/fern-docs/SKILL.md +++ b/skills/fern-docs/SKILL.md @@ -157,3 +157,8 @@ The bot comment contains: When sharing a preview with the user, use the specific page link(s) so they land directly on the changed content. + +If the bot comment only shows the site-root link and no per-page links, the repo's +preview workflow is outdated. Point the user to the reference workflow at +https://github.com/fern-api/docs-starter/blob/main/.github/workflows/preview-docs.yml +and suggest updating their `.github/workflows/preview-docs.yml` to match it.