Merged
Conversation
Wrap content under 'Add the SDK generator' and 'Generate the SDK' headings in <Step> components so they render as numbered steps inside <Steps>. Previously the markdown headings did not auto-convert when mixed with explicit <Step> components, causing the rendered numbering to skip from step 3 to step 16.
Contributor
|
🌿 Preview your docs: https://fern-preview-858cb632-66d4-436f-ad52-7c6999f0ba97.docs.buildwithfern.com/learn Here are the markdown pages you've updated: |
Contributor
Author
|
Requested by: devin |
devalog
approved these changes
May 4, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
The SDK quickstart pages for Python, C#, Go, Java, PHP, Ruby, and Swift had broken step numbering — the visible step count jumped from 3 to 16 part-way through (see https://buildwithfern.com/learn/sdks/generators/python/quickstart for the live example).
Root cause
These pages mixed two patterns inside a single
<Steps>block:<Step title="…">components (from snippets likeinit-fern-folder.mdxandsetup-github-repos.mdx)### Add the SDK generatorand### Generate the SDKmarkdown headingsThe renderer auto-numbers
<Step>components correctly, but when those headings are mixed in alongside, the headings are not auto-converted to steps. Instead, every loose block between the explicit<Step>from theinit-fern-foldersnippet (step 3) and the next explicit<Step>from thesetup-github-repossnippet (paragraphs, code blocks,<Note>,<Files>, etc.) shifted the count, so "Set up GitHub repositories" rendered as step 16.Fix
Wrapped the "Add the SDK generator" and "Generate the SDK" content in proper
<Step title="…">components in all 7 affected SDK quickstarts (and their Simplified Chinese translations underfern/translations/zh/). This matches the pattern already used by the Rust and TypeScript quickstarts, which render correctly.After this change, each quickstart should render as a clean 1-through-N sequence.
Files changed
fern/products/sdks/generators/{csharp,go,java,php,python,ruby,swift}/quickstart.mdxfern/translations/zh/products/sdks/generators/{csharp,go,java,php,python,ruby,swift}/quickstart.mdxRequested by: Fern Support