From 1fc08d8bc977b2539478436e2bae325da4c01706 Mon Sep 17 00:00:00 2001 From: "fern-api[bot]" <115122769+fern-api[bot]@users.noreply.github.com> Date: Wed, 2 Sep 2026 17:42:43 +0000 Subject: [PATCH] =?UTF-8?q?Expand=20generators.yml=20schema=20tip=20to=20c?= =?UTF-8?q?larify=20editor=20support=20(VS=20Code,=20In=E2=80=A6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- fern/products/sdks/reference/generators-yml-reference.mdx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/fern/products/sdks/reference/generators-yml-reference.mdx b/fern/products/sdks/reference/generators-yml-reference.mdx index ffd2b1cee..2d34d594f 100644 --- a/fern/products/sdks/reference/generators-yml-reference.mdx +++ b/fern/products/sdks/reference/generators-yml-reference.mdx @@ -9,6 +9,10 @@ The `generators.yml` file serves two purposes: it declares your API definition ( To enable intelligent YAML validation and autocompletion in your editor, add a schema directive to the top of your `generators.yml` file. + + The `# yaml-language-server: $schema=...` comment is recognized by the [YAML Language Server](https://github.com/redhat-developer/yaml-language-server), which powers YAML support in **VS Code** (via the [YAML extension](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-yaml)) and other editors that embed the YAML Language Server. + + **IntelliJ IDEA** does not use the YAML Language Server comment directive. To get schema validation in IntelliJ, open **Preferences → Languages & Frameworks → Schemas and DTDs → JSON Schema Mappings**, add a new mapping, set the schema URL to `https://schema.buildwithfern.dev/generators-yml.json`, and map it to your `generators.yml` file. ```yaml title="generators.yml" maxLines=10