Skip to content

Clarify MCP plans, schema directive editors, SDK naming, and generated … - #6822

Open
fern-api[bot] wants to merge 1 commit into
mainfrom
2026-09-02-fern-ai-2fbdc2-8787d192
Open

Clarify MCP plans, schema directive editors, SDK naming, and generated …#6822
fern-api[bot] wants to merge 1 commit into
mainfrom
2026-09-02-fern-ai-2fbdc2-8787d192

Conversation

@fern-api

@fern-api fern-api Bot commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

Added a plan-availability callout to the MCP server page (Ask Fern on Hobby, Team, and Enterprise); expanded the generators.yml schema directive tip to explain what it does, which editors support it (VS Code, IntelliJ, Neovim via YAML Language Server), and the CLI version that introduced it; added two sections to the OpenAPI method-names page comparing x-fern-sdk-group-name with x-fern-sdk-namespace and showing how to rename schemas/response types with x-fern-type-name (linked to the schema-names page); and updated the SDK testing page to state that Fern writes .github/workflows/ci.yml automatically (no manual GitHub Actions setup) plus a note that the TypeScript SDK has no option to disable JSDoc comment generation.

…xtensions, and generated CI

Co-Authored-By: bot_apk <apk@cognition.ai>
@fern-api
fern-api Bot requested a review from devalog as a code owner September 2, 2026 17:46

Fern auto-generates tests that must pass before SDK release. Fern generates a GitHub workflow in each SDK repository that runs unit tests and any enabled mock server tests on every pull request, commit, and release.

CI is generated automatically. When you enable generated tests, Fern writes a `.github/workflows/ci.yml` file into your SDK repository alongside the SDK code. You do not need to configure GitHub Actions yourself. If you add custom tests, include their files in `.fernignore` to prevent them from being overwritten on the next generation.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚫 [vale] <Microsoft.Contractions> reported by reviewdog 🐶
Use 'don't' instead of 'do not'.

Suggested change
CI is generated automatically. When you enable generated tests, Fern writes a `.github/workflows/ci.yml` file into your SDK repository alongside the SDK code. You do not need to configure GitHub Actions yourself. If you add custom tests, include their files in `.fernignore` to prevent them from being overwritten on the next generation.
CI is generated automatically. When you enable generated tests, Fern writes a `.github/workflows/ci.yml` file into your SDK repository alongside the SDK code. You don't need to configure GitHub Actions yourself. If you add custom tests, include their files in `.fernignore` to prevent them from being overwritten on the next generation.

# yaml-language-server: $schema=https://schema.buildwithfern.dev/generators-yml.json
```

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), **IntelliJ IDEA** (via the YAML/Ansible plugin), **Neovim**, and other editors that support the language server protocol. Once active, your editor will:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] <FernStyles.Acronyms> reported by reviewdog 🐶
'IDEA' has no definition.

@github-actions

github-actions Bot commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants