diff --git a/fern/products/sdks/reference/generators-yml-reference.mdx b/fern/products/sdks/reference/generators-yml-reference.mdx index ffd2b1cee..9e24b46e8 100644 --- a/fern/products/sdks/reference/generators-yml-reference.mdx +++ b/fern/products/sdks/reference/generators-yml-reference.mdx @@ -8,7 +8,7 @@ max-toc-depth: 3 The `generators.yml` file serves two purposes: it declares your API definition (required for OpenAPI/AsyncAPI), and configures SDK generation, including which languages to generate, where to publish them, and how to customize each SDK. - To enable intelligent YAML validation and autocompletion in your editor, add a schema directive to the top of your `generators.yml` file. + To enable intelligent YAML validation and autocompletion in your editor, add a schema directive to the top of your `generators.yml` file. This directive 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)), **Neovim**, **Emacs**, and other editors that integrate the YAML Language Server. **IntelliJ IDEA** uses its own built-in YAML support and does not read the `yaml-language-server` directive natively; for schema validation in IntelliJ, configure the schema mapping in **Settings → Languages & Frameworks → Schemas and DTDs → JSON Schema Mappings** and point it to `https://schema.buildwithfern.dev/generators-yml.json`. ```yaml title="generators.yml" maxLines=10