Changelog

2.17.3

(fix): Gracefully handle null values in docs.yml structure.

2.17.2

(fix): Escape $ when inferring examples from literals that start with $. This fixes validation issues like Example $ending is malformed. Examples should be formatted like $YourType.ExampleName.

2.17.1

(fix): Fix file scope type resolution for inline request properties

2.17.0

(feat): Add substitute-env-vars flag to docs.yml settings configuration. When set to true, environment variables using ${VAR_NAME} syntax are substituted across all files in the docs bundle, including markdown/MDX content. This is useful for injecting dynamic values like API keys or URLs. Use ${VAR} to escape and output literal ${VAR} without substitution.

2.16.0

(feat): Add support for aliases in generators.yml. You can now define aliases that map to multiple groups, allowing you to run multiple groups with a single command.

1
# generators.yml
2
aliases:
3
  all: ["php-sdk", "ts-sdk", "go-sdk"]
4
5
groups:
6
  php-sdk:
7
    generators: ...
8
  ts-sdk:
9
    generators: ...
10
  go-sdk:
11
    generators: ...

Then run fern generate all to generate all three SDKs at once.

2.15.2

(fix): Fix fern check incorrectly reporting SDK method conflicts for endpoints with the same x-fern-sdk-group-name and x-fern-sdk-method-name when they are in different namespaces. The validator now correctly allows duplicate SDK method names across different namespaces, matching the generator behavior where namespace is prepended to the SDK group name.

2.15.1

(fix): Improve CI environment detection to properly detect Azure Pipelines and other CI systems. This prevents unnecessary prompts when running fern generate --docs in CI environments.

2.15.0

(feat): Infer example for literal and enum types when generating IR from OpenAPI and Fern Definition.

2.14.1

(fix): Fix 2.0.0-rc0 CLI migration to properly migrate coerce-enums-to-literals setting for AsyncAPI specs. Previously, the migration only handled this setting for OpenAPI specs.