Skip to content

docs: document how fern generate picks the SDK version - #6508

Closed
devin-ai-integration[bot] wants to merge 1 commit into
mainfrom
devin/1785769852-sdk-version-numbers
Closed

docs: document how fern generate picks the SDK version#6508
devin-ai-integration[bot] wants to merge 1 commit into
mainfrom
devin/1785769852-sdk-version-numbers

Conversation

@devin-ai-integration

Copy link
Copy Markdown
Contributor

Summary

Users repeatedly ask how the SDK version number is chosen by fern generate, and teams on github: mode: pull-request are surprised that re-running generation on an unmerged branch doesn't keep incrementing. Nothing in the public docs covered cloud version selection: the only versioning page is the self-hosted one (--version AUTO / fern ir + fern diff), and the CLI reference only documented explicit --version X.Y.Z.

Adds a ## Version numbers section to How SDKs work covering:

  • the three ways a version is determined (explicit, computed, AUTO) in a table
  • the three version sources (registry, GitHub release tag, sdkVersion in .fern/metadata.json) with the highest-wins + patch-bump rule
  • idempotence on an unmerged branch, and the pull-request/push + one explicit-version release run pattern
  • the prerelease-line caveat and explicit-version promotion

The CLI --version flag docs get a one-line pointer to that section. --version AUTO details stay on the existing self-hosted versioning page; the new subsection links there instead of restating the setup.

Checks: pre-commit run --files <changed> (0 errors; remaining Vale warnings are pre-existing lines in commands.mdx) and fern check --warnings (0 errors).

Link to Devin session: https://app.devin.ai/sessions/dcbfc8b012a24e48ae8f64b0685dcfa8

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@devin-ai-integration
devin-ai-integration Bot requested a review from devalog as a code owner August 3, 2026 15:11
@devin-ai-integration

Copy link
Copy Markdown
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment, CI, and merge conflict monitoring

@github-actions

github-actions Bot commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

@devalog devalog closed this Aug 3, 2026
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.

1 participant