Skip to content

docs(sdks): describe branch support in release mode#5115

Open
Swimburger wants to merge 1 commit intomainfrom
devin/1776915448-release-branch-docs
Open

docs(sdks): describe branch support in release mode#5115
Swimburger wants to merge 1 commit intomainfrom
devin/1776915448-release-branch-docs

Conversation

@Swimburger
Copy link
Copy Markdown
Member

@Swimburger Swimburger commented Apr 23, 2026

Summary

The branch ParamField under github release mode in generators-yml-reference.mdx previously had no description. This PR fills it in to explain the new behavior (the field is being wired up across fiddle + fern — see https://github.com/fern-api/fiddle/pull/713 and fern-api/fern#15298):

  • fern/products/sdks/reference/generators-yml-reference.mdx: describe that branch under release mode retargets commits and the release tag to the specified branch, and note the versioned-SDK use case.
  • fern/products/sdks/snippets/github-publishing-mode.mdx: mention the optional branch override in the release-mode bullet.

Review & Testing Checklist for Human

  • Confirm the wording matches how you want release-mode + branch to be described to users.
  • Verify the page renders correctly in preview (AccordionGroup > Release accordion, the branch ParamField now has a description).

Notes

This PR documents behavior that will be functional once fiddle PR https://github.com/fern-api/fiddle/pull/713 is merged, tagged, and the follow-up fern PR bumps @fern-fern/fiddle-sdk to wire branch through. Schema acceptance of branch under mode: release is already landing via fern-api/fern#15298, so users running a fern CLI built from that PR can set the field without a validation error even before fiddle is deployed.

Link to Devin session: https://app.devin.ai/sessions/11840acb772748b294bc5001ab3f7d81
Requested by: @Swimburger


Open in Devin Review

Expand the 'branch' ParamField under release-mode github config to
explain that it retargets commits and tags to a non-default branch,
and mention the new optional behavior in the publishing-mode snippet.

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@devin-ai-integration
Copy link
Copy Markdown
Contributor

🤖 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 and CI monitoring

Copy link
Copy Markdown
Contributor

@devin-ai-integration devin-ai-integration Bot left a comment

Choose a reason for hiding this comment

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

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no potential bugs to report.

View in Devin Review to see 1 additional finding.

Open in Devin Review

@github-actions
Copy link
Copy Markdown
Contributor

🌿 Preview your docs: https://fern-preview-devin-1776915448-release-branch-docs.docs.buildwithfern.com/learn

Here are the markdown pages you've updated:

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.

2 participants