Skip to content

Add missing-redirects check mention to redirects and slug pages #5177

Merged
devalog merged 4 commits intomainfrom
fern/add-missing-redirects-check-mention
Apr 28, 2026
Merged

Add missing-redirects check mention to redirects and slug pages #5177
devalog merged 4 commits intomainfrom
fern/add-missing-redirects-check-mention

Conversation

@fern-api
Copy link
Copy Markdown
Contributor

@fern-api fern-api Bot commented Apr 27, 2026

Summary

Adds a mention of the missing-redirects check rule to the redirects page and the configuring-slugs page, so users discover the feature when reading about redirects and slug customization.

Changes

  • Redirects page (fern/products/docs/pages/seo/redirects.mdx): Added a new "Catching missing redirects" section describing the missing-redirects rule for fern check, with a code example and links to the full check configuration.
  • Configuring slugs page (fern/products/docs/pages/seo/configuring-slugs.mdx): Added a <Note> callout reminding users that changing a slug updates the page URL and they should run fern check to catch missing redirects.

Requested by: Fern Support

@fern-api fern-api Bot requested a review from devalog as a code owner April 27, 2026 20:27
@fern-api
Copy link
Copy Markdown
Contributor Author

fern-api Bot commented Apr 27, 2026

Requested by: devin
Slack thread: View conversation

missing-redirects: error
```

The check requires authentication via `fern login` or the `FERN_TOKEN` environment variable. It is skipped on first publish, when unauthenticated, or when the network is unavailable.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚫 [vale] reported by reviewdog 🐶
[Microsoft.Contractions] Use 'it's' instead of 'It is'.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 27, 2026

Errors below are surfaced by `fern check` and `fern generate --docs`.

### Page "X" was moved from "/old" to "/new". The old URL will return 404 without a redirect.
### Page "X" was moved from "/old" to "/new". The old URL will return 404 without a redirect. Consider adding a redirect in docs.yml to preserve existing links.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [vale] reported by reviewdog 🐶
[FernStyles.Current] Avoid time-relative terms like 'old' that become outdated

Errors below are surfaced by `fern check` and `fern generate --docs`.

### Page "X" was moved from "/old" to "/new". The old URL will return 404 without a redirect.
### Page "X" was moved from "/old" to "/new". The old URL will return 404 without a redirect. Consider adding a redirect in docs.yml to preserve existing links.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [vale] reported by reviewdog 🐶
[FernStyles.Current] Avoid time-relative terms like 'old' that become outdated

Errors below are surfaced by `fern check` and `fern generate --docs`.

### Page "X" was moved from "/old" to "/new". The old URL will return 404 without a redirect.
### Page "X" was moved from "/old" to "/new". The old URL will return 404 without a redirect. Consider adding a redirect in docs.yml to preserve existing links.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] reported by reviewdog 🐶
[FernStyles.HeadingPunctuation] Don't use end punctuation in headings.

```

### Page "X" was removed. The previously published URL "/old" will return 404 without a redirect.
### Page "X" was removed. The previously published URL "/old" will return 404 without a redirect. Consider adding a redirect in docs.yml to preserve existing links.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [vale] reported by reviewdog 🐶
[FernStyles.Current] Avoid time-relative terms like 'old' that become outdated

```

### Page "X" was removed. The previously published URL "/old" will return 404 without a redirect.
### Page "X" was removed. The previously published URL "/old" will return 404 without a redirect. Consider adding a redirect in docs.yml to preserve existing links.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] reported by reviewdog 🐶
[FernStyles.HeadingPunctuation] Don't use end punctuation in headings.

@devalog devalog merged commit a55b604 into main Apr 28, 2026
2 checks passed
@devalog devalog deleted the fern/add-missing-redirects-check-mention branch April 28, 2026 19:36
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