feat(docs): add translations block to docs.yml

[fern-support]

Summary

• Adds a translations block to docs.yml that declares the locales a documentation site supports
• Each entry has a required lang (one of the supported Language enum values) and an optional default: true flag
• Wires the field through the full config pipeline: Zod schema → parsed config → JSON schema validation → Fern API definition

Example usage

translations:
  - lang: en
    default: true
  - lang: ja
  - lang: fr

Files changed

Area	Change
DocsYmlSchemas.ts	New TranslationConfig Zod schema; translations added to DocsConfiguration
Generated SDK types	New TranslationConfig.ts interface; translations added to DocsConfiguration.ts
Serialization schemas	New TranslationConfig.ts serializer; translations added to serialization DocsConfiguration.ts
ParsedDocsConfiguration.ts	`translations: TranslationConfig[]
parseDocsConfiguration.ts	Pass-through for translations
JSON schemas	translations property + docs.TranslationConfig definition in both docs-yml.schema.json files
Fern API definition	TranslationConfig type and translations property in docs.yml

Test plan

• Unit tests for TranslationConfig Zod schema (valid langs, invalid codes, optional default)
• Unit tests for DocsConfiguration with translations field (absent, single, multiple, mixed with languages)
• Integration tests for parseDocsConfiguration confirming translations passes through correctly
• pnpm turbo run compile --filter @fern-api/configuration --filter @fern-api/configuration-loader — clean
• All existing tests in both packages pass

🤖 Generated with Claude Code

[github-actions]

🌱 Seed Test Selector

Select languages to run seed tests for:

• Python
• TypeScript
• Java
• Go
• Ruby
• C#
• PHP
• Swift
• Rust
• OpenAPI

---

How to use: Click the ⋯ menu above → "Edit" → check the boxes you want → click "Update comment". Tests will run automatically and snapshots will be committed to this PR.

[dsinghvi]

@claude review

[claude]

Claude Code Review

This repository is configured for manual code reviews. Comment @claude review to trigger a review and subscribe this PR to future pushes, or @claude review once for a one-time review.

_{Tip: disable this comment in your organization's Code Review settings.}

[github-actions]

Docs Generation Benchmark Results

Comparing PR branch against median of 5 nightly run(s) on main (latest: 2026-04-23T04:59:11Z).

Fixture	main	PR	Delta
docs	301.0s (n=5)	297.9s (35 versions)	-3.1s (-1.0%)

Docs generation runs fern generate --docs --preview end-to-end against the benchmark fixture with 35 API versions (each version: markdown processing + OpenAPI-to-IR + FDR upload).
Delta is computed against the nightly baseline on main.
Baseline from nightly run(s) on main (latest: 2026-04-23T04:59:11Z). Trigger benchmark-baseline to refresh.
Last updated: 2026-04-27 00:47 UTC

[github-actions]

SDK Generation Benchmark Results

Comparing PR branch against median of 5 nightly run(s) on main (latest: 2026-04-23T04:59:11Z).

Full benchmark table (click to expand)

Generator	Spec	main (generator)	main (E2E)	PR (generator)	Delta
csharp-sdk	square	56s (n=5)	86s (n=5)	51s	-5s (-8.9%)
go-sdk	square	115s (n=5)	132s (n=5)	115s	+0s (+0.0%)
java-sdk	square	179s (n=5)	207s (n=5)	190s	+11s (+6.1%)
php-sdk	square	43s (n=5)	66s (n=5)	42s	-1s (-2.3%)
python-sdk	square	115s (n=5)	223s (n=5)	119s	+4s (+3.5%)
ruby-sdk-v2	square	130s (n=5)	159s (n=5)	130s	+0s (+0.0%)
rust-sdk	square	166s (n=5)	163s (n=5)	170s	+4s (+2.4%)
swift-sdk	square	41s (n=5)	290s (n=5)	40s	-1s (-2.4%)
ts-sdk	square	74s (n=5)	86s (n=5)	73s	-1s (-1.4%)

main (generator): generator-only time via --skip-scripts (includes Docker image build, container startup, IR parsing, and code generation — this is the same Docker-based flow customers use via fern generate). main (E2E): full customer-observable time including build/test scripts (nightly baseline, informational). Delta is computed against generator-only baseline.
⚠️ = generation exited with a non-zero exit code (timing may not reflect a successful run).
Baseline from nightly runs on main (latest: 2026-04-23T04:59:11Z). Trigger benchmark-baseline to refresh.
Last updated: 2026-04-27 00:47 UTC