Add Fern SDKs vs OpenAPI Generator comparison page #2869

devin-ai-integration · 2025-12-18T17:01:17Z

Summary

Adds a new documentation page comparing Fern-generated SDKs to OpenAPI Generator SDKs. The page is placed in a hidden "Resources" section at the end of the SDKs navigation and covers:

Documentation & onboarding quality
Client ergonomics and API design
Authentication & OAuth token lifecycle
Pagination with async iterators
Typed error handling
Resilience features (retries, timeouts, abort signals)
Logging with sensitive data redaction
Raw response access patterns
Runtime compatibility (Node, Deno, Bun, Workers, React Native)
Testing and code quality

The comparison uses AccordionGroup components with side-by-side code examples and feature comparison tables, following the format established in the existing Stainless comparison page.

Updates since last revision

Fixed vale linting issues: capitalized "API Reference" and removed unnecessary adverb "quickly"
Changed code block format from bolded titles (**Fern SDK:**) to code fence titles ( ```typescript Fern SDK)
Removed Summary section and integrated key points into the Overview paragraph
Moved page from Overview section to a new hidden "Resources" section at the end of navigation

Review & Testing Checklist for Human

Verify hidden section behavior: Page is now in a hidden "Resources" section - confirm this is the desired visibility (page accessible via direct URL but not shown in navigation)
Review claims for accuracy: Some statements (e.g., "README is minimal/title only" for OpenAPI Generator) are based on a specific demo repo - verify these are fair generalizations
Check code examples: The TypeScript snippets are illustrative - verify they accurately represent both SDKs' APIs
Verify page renders correctly: Preview the page to ensure AccordionGroup/Accordion components, code blocks with titles, and tables render properly

Recommended test plan: Deploy preview and navigate directly to /sdks/fern-vs-openapi-generator. Verify the page does NOT appear in the sidebar navigation. Expand each accordion section and verify formatting. Have someone familiar with both tools review for factual accuracy.

Notes

Comparison is based on analysis of https://github.com/fern-demo/fern-ts-sdk vs https://github.com/fern-demo/oss-ts-sdk
Format follows the existing Stainless comparison page pattern (stainless-comparison.mdx)

Link to Devin run: https://app.devin.ai/sessions/6419d0f32163483496509efaceb528e1
Requested by: Chris McDonnell ([email protected]) / @cdonel707

Co-Authored-By: Chris McDonnell <[email protected]>

devin-ai-integration · 2025-12-18T17:01:20Z

🤖 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

github-actions · 2025-12-18T17:01:34Z

fern/products/sdks/fern-vs-openapi-generator.mdx

+
+| Capability | Fern | OpenAPI Generator |
+|------------|------|-------------------|
+| **Documentation** | Comprehensive README + API reference | Minimal (title only) |


🚫 [vale] _{reported by reviewdog 🐶}
[FernStyles.Reject] Use 'API Reference' instead of 'API reference'.

github-actions · 2025-12-18T17:01:34Z

fern/products/sdks/fern-vs-openapi-generator.mdx

+<AccordionGroup>
+<Accordion title="Documentation and onboarding" defaultOpen={true}>
+
+Fern SDKs ship with comprehensive documentation that enables developers to get started quickly without reading generated code. OpenAPI Generator output requires developers to infer usage patterns from the generated files.


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Adverbs] Remove 'quickly' if it's not important to the meaning of the statement.

github-actions · 2025-12-18T17:01:34Z

fern/products/sdks/fern-vs-openapi-generator.mdx

+| Feature | Fern | OpenAPI Generator |
+|---------|------|-------------------|
+| **README** | Comprehensive guide covering installation, auth, types, errors, pagination, retries, timeouts, logging, and runtime compatibility | Minimal (often just a title) |
+| **API reference** | Generated `reference.md` with usage examples for every endpoint | None |


🚫 [vale] _{reported by reviewdog 🐶}
[FernStyles.Reject] Use 'API Reference' instead of 'API reference'.

github-actions · 2025-12-18T17:01:34Z

fern/products/sdks/fern-vs-openapi-generator.mdx

+
+<Accordion title="Runtime compatibility and packaging">
+
+Fern explicitly supports multiple JavaScript runtimes and ships with proper ESM/CJS dual builds. OpenAPI Generator has basic module support.


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Acronyms] 'ESM' has no definition.

github-actions · 2025-12-18T17:01:34Z

fern/products/sdks/fern-vs-openapi-generator.mdx

+
+<Accordion title="Runtime compatibility and packaging">
+
+Fern explicitly supports multiple JavaScript runtimes and ships with proper ESM/CJS dual builds. OpenAPI Generator has basic module support.


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Acronyms] 'CJS' has no definition.

github-actions · 2025-12-18T17:01:34Z

fern/products/sdks/resources/fern-vs-openapi-generator.mdx

+| **Bun** | 1.0+ | Not documented |
+| **Cloudflare Workers** | Yes | Not documented |
+| **React Native** | Yes | Not documented |
+| **ESM/CJS builds** | Dual builds with proper exports | Basic ESM/CJS |


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Acronyms] 'ESM' has no definition.

github-actions · 2025-12-18T17:01:34Z

fern/products/sdks/resources/fern-vs-openapi-generator.mdx

+| **Bun** | 1.0+ | Not documented |
+| **Cloudflare Workers** | Yes | Not documented |
+| **React Native** | Yes | Not documented |
+| **ESM/CJS builds** | Dual builds with proper exports | Basic ESM/CJS |


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Acronyms] 'CJS' has no definition.

github-actions · 2025-12-18T17:01:34Z

fern/products/sdks/resources/fern-vs-openapi-generator.mdx

+| **Bun** | 1.0+ | Not documented |
+| **Cloudflare Workers** | Yes | Not documented |
+| **React Native** | Yes | Not documented |
+| **ESM/CJS builds** | Dual builds with proper exports | Basic ESM/CJS |


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Acronyms] 'ESM' has no definition.

github-actions · 2025-12-18T17:01:34Z

fern/products/sdks/resources/fern-vs-openapi-generator.mdx

+| **Bun** | 1.0+ | Not documented |
+| **Cloudflare Workers** | Yes | Not documented |
+| **React Native** | Yes | Not documented |
+| **ESM/CJS builds** | Dual builds with proper exports | Basic ESM/CJS |


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Acronyms] 'CJS' has no definition.

github-actions · 2025-12-18T17:02:07Z

🌿 Preview your docs: https://fern-preview-762fc6d7-0d27-4e5d-b1d9-621e3b112290.docs.buildwithfern.com/learn

Co-Authored-By: Chris McDonnell <[email protected]>

github-actions · 2025-12-18T17:09:11Z

🌿 Preview your docs: https://fern-preview-22373252-aade-4f95-a7a3-b336d039b12d.docs.buildwithfern.com/learn

devalog · 2025-12-18T19:39:40Z

fern/products/sdks/fern-vs-openapi-generator.mdx

+
+Fern presents a single unified client with intuitive namespaces that align with how developers think about APIs. OpenAPI Generator requires instantiating separate API classes.
+
+**Fern SDK:**


don't use bolded titles like this for a codeblock, instead use this format, here and throughout:

typescript Fern SDK

devalog · 2025-12-18T19:42:00Z

fern/products/sdks/fern-vs-openapi-generator.mdx

+</Accordion>
+</AccordionGroup>
+
+## Summary


no need to have a separate summary section. integrate this info into the intro paragraph and delete any excess info (stay concise)

Co-Authored-By: Chris McDonnell <[email protected]>

devalog · 2025-12-18T19:43:48Z

fern/products/sdks/sdks.yml

      - page: Capabilities
        path: ./capabilities.mdx
        slug: capabilities
+      - page: Fern SDKs vs OpenAPI Generator


this should be in a separate section called "Resources" that is at the end and marked as hidden

github-actions · 2025-12-18T19:44:36Z

🌿 Preview your docs: https://fern-preview-81a60304-8afa-4ecb-a04a-e5c0c114df3e.docs.buildwithfern.com/learn

Co-Authored-By: Chris McDonnell <[email protected]>

github-actions · 2025-12-18T19:46:28Z

🌿 Preview your docs: https://fern-preview-75b1d552-320f-4359-bbf7-ff606211e69d.docs.buildwithfern.com/learn

github-actions · 2025-12-18T20:36:14Z

fern/products/sdks/resources/fern-vs-openapi-generator.mdx

+
+## Runtime compatibility and packaging
+
+Fern supports multiple JavaScript runtimes with ESM/CJS dual builds and automatic runtime detection. OpenAPI Generator provides ESM/CJS support.


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Acronyms] 'ESM' has no definition.

github-actions · 2025-12-18T20:36:14Z

fern/products/sdks/resources/fern-vs-openapi-generator.mdx

+
+## Runtime compatibility and packaging
+
+Fern supports multiple JavaScript runtimes with ESM/CJS dual builds and automatic runtime detection. OpenAPI Generator provides ESM/CJS support.


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Acronyms] 'CJS' has no definition.

github-actions · 2025-12-18T20:36:14Z

fern/products/sdks/resources/fern-vs-openapi-generator.mdx

+
+## Runtime compatibility and packaging
+
+Fern supports multiple JavaScript runtimes with ESM/CJS dual builds and automatic runtime detection. OpenAPI Generator provides ESM/CJS support.


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Acronyms] 'ESM' has no definition.

github-actions · 2025-12-18T20:36:14Z

fern/products/sdks/resources/fern-vs-openapi-generator.mdx

+
+## Runtime compatibility and packaging
+
+Fern supports multiple JavaScript runtimes with ESM/CJS dual builds and automatic runtime detection. OpenAPI Generator provides ESM/CJS support.


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Acronyms] 'CJS' has no definition.

github-actions · 2025-12-18T20:36:57Z

🌿 Preview your docs: https://fern-preview-e4b86f2b-c7e5-4965-ad05-4a658a8932e5.docs.buildwithfern.com/learn

github-actions · 2025-12-18T20:42:23Z

🌿 Preview your docs: https://fern-preview-efc73daa-ff27-4eb2-9e55-8f59d9f5887f.docs.buildwithfern.com/learn

Add Fern SDKs vs OpenAPI Generator comparison page

ef07b65

Co-Authored-By: Chris McDonnell <[email protected]>

github-actions bot reviewed Dec 18, 2025

View reviewed changes

Fix vale linting issues: capitalize API Reference, remove adverb

b9b0e2d

Co-Authored-By: Chris McDonnell <[email protected]>

devalog reviewed Dec 18, 2025

View reviewed changes

Address PR feedback: use code fence titles, remove Summary section

93c8c47

Co-Authored-By: Chris McDonnell <[email protected]>

devalog reviewed Dec 18, 2025

View reviewed changes

Move comparison page to hidden Resources section

5ad1ca9

Co-Authored-By: Chris McDonnell <[email protected]>

devalog added 2 commits December 18, 2025 15:35

restructure and clean up tone

53889a6

vale fix

2f2d22f

github-actions bot reviewed Dec 18, 2025

View reviewed changes

title nit

691f288

devalog approved these changes Dec 18, 2025

View reviewed changes


		<Accordion title="Runtime compatibility and packaging">

		Fern explicitly supports multiple JavaScript runtimes and ships with proper ESM/CJS dual builds. OpenAPI Generator has basic module support.


		Fern presents a single unified client with intuitive namespaces that align with how developers think about APIs. OpenAPI Generator requires instantiating separate API classes.

		Fern SDK:


		## Runtime compatibility and packaging

		Fern supports multiple JavaScript runtimes with ESM/CJS dual builds and automatic runtime detection. OpenAPI Generator provides ESM/CJS support.

Add Fern SDKs vs OpenAPI Generator comparison page #2869

Are you sure you want to change the base?

Add Fern SDKs vs OpenAPI Generator comparison page #2869

Conversation

devin-ai-integration bot commented Dec 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Updates since last revision

Review & Testing Checklist for Human

Notes

Uh oh!

devin-ai-integration bot commented Dec 18, 2025

🤖 Devin AI Engineer

Uh oh!

github-actions bot Dec 18, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Dec 18, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Dec 18, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Dec 18, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Dec 18, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Dec 18, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Dec 18, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Dec 18, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Dec 18, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Dec 18, 2025

Uh oh!

github-actions bot commented Dec 18, 2025

Uh oh!

devalog Dec 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

devalog Dec 18, 2025

Choose a reason for hiding this comment

Uh oh!

devalog Dec 18, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Dec 18, 2025

Uh oh!

github-actions bot commented Dec 18, 2025

Uh oh!

github-actions bot Dec 18, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Dec 18, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Dec 18, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Dec 18, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Dec 18, 2025

Uh oh!

github-actions bot commented Dec 18, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

devin-ai-integration bot commented Dec 18, 2025 •

edited

Loading

devalog Dec 18, 2025 •

edited

Loading