(fix): Fix fern docs dev hot-reload for pages referenced outside the fern/ directory.
Previously, only changes to files inside the fern/ folder triggered preview refreshes.
Now, external directories containing referenced docs pages are also watched.
(feat): Add mcp option to page-actions in docs.yml. When set to false, the MCP server
endpoint is disabled, its URL is omitted from llms.txt and agent prompts, and the
“Connect to Claude Code” / “Connect to Cursor” buttons are hidden.
(fix): Add payload-format support for asymmetric webhook signature verification,
allowing the timestamp and other components to be included in the signed
payload. Previously, only the raw body was signed for asymmetric webhooks,
making the timestamp tolerance check ineffective against replay attacks.
(feat): Extract per-content-type OpenAPI examples into endpoint-level v2Examples
tagged with their content type. When an operation declares multiple content
types (e.g. application/json and application/ld+json) with distinct examples,
the importer now elevates those examples so docs can display the correct
example body when the user switches content types.
(fix): Fix product-level landing pages being dropped for unversioned products within a product group, and propagate top-level landing page to versioned navigation nodes as a fallback.
(internal): Revert AI example enhancement routing from FAI back to fdr-lambda-docs.
(feat): When running inside GitHub Actions, notable SDK generation events are now surfaced as
::notice:: annotations in the workflow run page and appended to the step summary.
Annotated events include PR creation, package publication (npm, PyPI, Maven, etc.),
no-changes-detected, and version tagging. Previously, these details were only visible
in debug-level log output.
(fix): Fix remote generation CLI hanging indefinitely when S3 download stalls.
Added connection timeout (60s) and overall download timeout (5 min) to
both downloadZipForTask and downloadAndExtractZipToDirectory, so the CLI
fails with a clear error instead of blocking forever.
(fix): Fix ledger publish path not forwarding the basepathAware flag for
multi-source docs sites, causing the manifest to be written to the
wrong storage key. Affected sites served stale content from the last
legacy publish instead of the updated ledger manifest.
(chore): Migrate library docs parser Docker images from fernapi to fernenterprise registry.
(fix): Fix fern docs dev failing with pnpm 10+ due to missing packages field
in generated pnpm-workspace.yaml and missing -w flag on pnpm i esbuild.
(feat): Add disambiguate-request-names setting to control whether generated request
wrapper names that collide with component schema names are renamed from
“*Request” to “*Body”. Defaults to true (current behavior). A CLI migration
for version 4.106.1 is included to explicitly set the flag to false for
projects that existed before disambiguation was introduced, preserving their
original “*Request” names.
(fix): Fix --instance flag silently publishing to the wrong docs instance when the provided URL does not match any configured instance. Previously the CLI would fall back to the first configured instance; now it fails with an error listing available instances.
(fix): Replace sed-based magic version replacement with pure Node.js implementation
in local generation mode. Fixes “illegal byte sequence” errors on binary files
and eliminates platform-specific behavior.
(fix): Fix a 500 (PruneEmptyError) in localized docs when a translated OpenAPI spec changed a
structural identifier (e.g. an OpenAPI tag name, which derives subpackage and endpoint ids)
relative to the default-locale spec. API-reference navigation nodes are now matched to the
translated definition by a stable locator (HTTP method + path) in addition to id, so localized
sidebar titles still apply and the renderer can resolve the served API. When a node cannot be
matched at all, the affected API falls back to the default-locale definition with a warning
instead of crashing.
(feat): Default docs deploy mode is now “ledger”, enabling faster incremental deployments
and faster first-time page renders for uncached pages. To take advantage of this,
bump the version field in your fern/fern.config.json to this release or
later — the CLI auto-redirects to the pinned version, so older pins will not pick
up the new default. You can also bump the version in one click from the Fern
dashboard. To revert back to the legacy flow, add FERN_DOCS_DEPLOY_MODE: legacy
to the env section of your GitHub Actions workflow. Legacy deploys will be
removed in a future version of the CLI.
(feat): Detect api-key: OIDC in NuGet output config and pass OIDC marker to
the C# generator for Trusted Publishing workflow generation.
(fix): Fix the next SDK version regressing to a stale baseline (e.g. 0.0.200) when
--version AUTO is omitted. When computing the next version, Fern now consults
every available source (package registry, GitHub release, and the sdkVersion
recorded in .fern/metadata.json) and bumps the highest one, so a stale registry
version can no longer override the version Fern last generated. For example,
5.0.0 now correctly bumps to 5.0.1.
(feat): Add support for remote git sources in generators.yml. API specs can now reference
files in git repositories using a git block with repo, ref, and path fields.
The CLI shallow-clones the repository at generation time using native git credentials.
(feat): Add a layout.changelog-layout option to docs.yml. Set it to classic to render the
legacy stacked changelog layout, or timeline (the default) for the searchable
timeline-of-cards layout.
(fix): Fix inline enum type names ignoring parent schema’s x-fern-type-name override.
When a parent schema was renamed via x-fern-type-name, inline enum properties
still derived their type name from the original parent name instead of the override.
(fix): Fix --version AUTO corrupting generated SDK code by replacing all occurrences
of the literal string “AUTO” (e.g. SENSOR_MODE_AUTO, CORRELATION_TYPE_AUTOMATED)
with the version number. The generator now receives the safe magic placeholder
version (0.0.0-fern-placeholder) instead of “AUTO”, and the post-generation
sed replacement targets only that placeholder.
(feat): Preserve OpenAPI info.version through the IR as specVersion. This allows
non-semver version formats (e.g. CalVer 2026-06-23) to be carried through
the pipeline instead of being replaced with the default 1.0.0.
(fix): Forward edit-this-page GitHub config (owner/repo/branch/host) from docs.yml
into the ledger manifest so the docs reader can synthesize the correct
“Edit this page” URL without depending on runtime git provenance.
(fix): fern check no longer reports valid examples as invalid when a schema uses
patternProperties (OpenAPI 3.1 / JSON Schema). When a schema declares
patternProperties, example keys are no longer flagged as unexpected additional
properties — including under additionalProperties: false.
(fix): Fixed the local C# dynamic-snippet test runner so it strips the docs-only
exported-client-class-name override before generating snippet tests. The compiled snippets now
reference the generated client class instead of the customer-provided wrapper, which is not part
of generator output.
