Skip to content

Clarify prerequisites, org name, and login in SDK quickstarts - #6698

Open
fern-api[bot] wants to merge 2 commits into
mainfrom
2026-08-20-fern-ai-d8be69-b699122d
Open

Clarify prerequisites, org name, and login in SDK quickstarts#6698
fern-api[bot] wants to merge 2 commits into
mainfrom
2026-08-20-fern-ai-d8be69-b699122d

Conversation

@fern-api

@fern-api fern-api Bot commented Aug 20, 2026

Copy link
Copy Markdown
Contributor

Both SDK quickstarts now open with a Prerequisites list (Node.js 18+, an OpenAPI spec or the Petstore example, and a Fern account needed for fern generate). The shared "Initialize the fern folder" step explains that <YourOrganization> is the organization name on your Fern account, visible in the Fern Dashboard, and cannot contain spaces. The SDK overview quickstart's Generate step documents the first-run login prompt, and the Ruby quickstart explains the generators.yml snippet: ruby-sdk is the group name passed to --group (and renameable), fern-ruby-sdk is Fern's official Ruby generator, and local-file-system writes to output.path until you switch the location to github to publish. The Ruby quickstart also now shows ruby-sdk correctly nested under the groups: top-level key.

@fern-api
fern-api Bot requested a review from devalog as a code owner August 20, 2026 16:08
</Step>
<Step title="Initialize the fern folder">
Initialize the fern folder with your existing OpenAPI specification. Specify your organization name using the `--organization` flag.
Initialize the fern folder with your existing OpenAPI specification. Specify your organization name using the `--organization` flag. Replace `<YourOrganization>` with the organization name on your Fern account, visible in the [Fern Dashboard](https://buildwithfern.com/dashboard). Organization names cannot contain spaces.

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 'can't' instead of 'cannot'.

Suggested change
Initialize the fern folder with your existing OpenAPI specification. Specify your organization name using the `--organization` flag. Replace `<YourOrganization>` with the organization name on your Fern account, visible in the [Fern Dashboard](https://buildwithfern.com/dashboard). Organization names cannot contain spaces.
Initialize the fern folder with your existing OpenAPI specification. Specify your organization name using the `--organization` flag. Replace `<YourOrganization>` with the organization name on your Fern account, visible in the [Fern Dashboard](https://buildwithfern.com/dashboard). Organization names can't contain spaces.

@github-actions

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