Skip to content
Open
Changes from all commits
Commits
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
20 changes: 20 additions & 0 deletions skills/fern-docs/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -142,3 +142,23 @@ 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.

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.