> This page is for Fern CLI.

> For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://buildwithfern.com/learn/llms.txt.

## 5.8.2

**`(chore):`** Remove `break` from the supported changelog types so the automated release flow
cannot produce a major version bump. Major releases must now be made by editing
the relevant `versions.yml` directly so the breaking change is explicitly
acknowledged in review. Validation rejects `type: break` in `unreleased/`.

## 5.8.1

**`(fix):`** Add a `valid-changelog-slug` rule to `fern check` that errors when a changelog's
effective URL slug is not one of the values served as an RSS/Atom/JSON feed by
the docs platform (`changelog`, `changelogs`, `release-notes`, `releasenotes`,
`whats-new`, `whatsnew`). Severity defaults to `error` and can be overridden
via `check.rules.valid-changelog-slug` in `docs.yml`.

## 5.8.0

**`(feat):`** Add support for a custom `robots.txt` file in `docs.yml`. Set `agents.robots-txt` to a relative
filepath and Fern will host the file at `/robots.txt` on your docs site, overriding the
auto-generated default.

**`(fix):`** Show a clear, actionable error when the Fern GitHub App is not installed on
the target repository instead of the generic "Failed to create job" message.

## 5.7.10

**`(fix):`** Fix the OpenAPI 3.1 -> IR converter to respect endpoint-level `security: []` opt-outs when `auth` is configured in `generators.yml`. Previously, declaring an `auth` scheme at the workspace level would silently override every endpoint-level `security` field — including explicit empty-array opt-outs — so endpoints that intentionally opted out of auth (e.g. an OAuth token endpoint, or a public endpoint) ended up rendered in docs and SDKs as if they required the global auth scheme.

## 5.7.9

**`(fix):`** `fern docs dev` now fails with a clear error when no `docs.yml` is present, instead of exiting silently.

**`(fix):`** Fix section landing pages with `skip-slug: true` ignoring frontmatter `slug` declarations.
Sections now compute separate slugs for the overview page (honors frontmatter) and for
children (respects skip-slug), so both features work correctly together.

## 5.7.8

**`(fix):`** Fix `fern logout` showing a "localhost refused to connect" error page by
starting a local server to serve a branded confirmation page, matching the login flow.
Also update both login and logout confirmation pages with new branded designs.