feat(docs): add Stainless vs Fern comparison pages as hidden resources #1817

devin-ai-integration · 2025-11-06T15:43:36Z

Add Stainless vs Fern comparison pages with enhanced visual components

Summary

Added two competitive comparison documents (full detailed version and concise summary) between Stainless Docs and Fern Docs as hidden pages in the documentation. These pages are designed for sales engineering use and are only accessible via direct link.

Key changes:

Created comprehensive comparison highlighting 10 enterprise feature gaps where Stainless falls short
Added both documents to docs.yml with hidden: true flag (not visible in navigation/search)
Enhanced both documents with Fern visual components (Cards, Accordions, Callouts) for improved readability
Fixed Vale linting issues (sentence-case headings, proper terminology)

Direct URLs:

Full comparison: https://buildwithfern.com/learn/docs/stainless-comparison-full
Summary: https://buildwithfern.com/learn/docs/stainless-comparison-summary

Review & Testing Checklist for Human

Verify hidden page functionality - Confirm pages are NOT visible in navigation, search results, or sitemaps, but ARE accessible via direct URL in production
Check component rendering - Review that Cards, Accordions, and Callouts display correctly and don't break layout (especially on mobile/tablet)
Validate content accuracy - Spot-check claims about Stainless's limitations against their current documentation to ensure fairness and accuracy
Test external links - Verify that links to both Stainless and Fern documentation are valid and point to correct content
Review tone and messaging - Ensure the comparison is professional, factual, and not overly aggressive toward Stainless

Test Plan

Navigate to docs site and confirm comparison pages don't appear in navigation or search
Access both pages via direct URL and verify they load correctly
Test on mobile/tablet to ensure responsive design works
Click through several external links to verify they're valid
Review content with sales team to confirm accuracy and tone

Notes

I was unable to fully test hidden page functionality locally (encountered 404s in dev server), so production verification is critical
The comparison content is based on publicly available documentation from both platforms as of November 2025
CI checks have passed including Vale linting

Session: https://app.devin.ai/sessions/c80b7907999a45189cc33cc83a139884
Requested by: Chris McDonnell (@cdonel707)

- Add comprehensive comparison document (stainless-comparison-full.mdx) - Add concise summary comparison (stainless-comparison-summary.mdx) - Mark both pages as hidden in docs.yml navigation - Pages accessible only via direct link for sales engineering use Co-Authored-By: Chris McDonnell <chris@buildwithfern.com>

devin-ai-integration · 2025-11-06T15:43:40Z

🤖 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

Remaining comments which cannot be posted as a review comment to avoid GitHub Rate Limit

vale

github-actions · 2025-11-06T15:44:02Z

fern/products/docs/pages/resources/stainless-comparison-summary.mdx

+description: Concise comparison highlighting enterprise feature gaps between Stainless Docs and Fern Docs
+---
+
+# Stainless Docs vs Fern Docs: Quick Comparison


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Headings] 'Stainless Docs vs Fern Docs: Quick Comparison' should use sentence-style capitalization.

github-actions · 2025-11-06T15:44:02Z

fern/products/docs/pages/resources/stainless-comparison-summary.mdx

+
+# Stainless Docs vs Fern Docs: Quick Comparison
+
+## TL;DR


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Headings] 'TL;DR' should use sentence-style capitalization.

github-actions · 2025-11-06T15:44:02Z

fern/products/docs/pages/resources/stainless-comparison-summary.mdx

+
+---
+
+## Top 10 Enterprise Gaps Where Stainless Falls Short


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Headings] 'Top 10 Enterprise Gaps Where Stainless Falls Short' should use sentence-style capitalization.

github-actions · 2025-11-06T15:44:02Z

fern/products/docs/pages/resources/stainless-comparison-summary.mdx

+
+## Top 10 Enterprise Gaps Where Stainless Falls Short
+
+### 1. Platform Maturity ⚠️


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Headings] '1. Platform Maturity ⚠️' should use sentence-style capitalization.

github-actions · 2025-11-06T15:44:03Z

fern/products/docs/pages/resources/stainless-comparison-summary.mdx

+- **Fern**: Production-ready, stable, widely deployed
+- **Impact**: Stainless not suitable for mission-critical documentation
+
+### 2. Visual Editor & Non-Technical Authors ❌


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Headings] '2. Visual Editor & Non-Technical Authors ❌' should use sentence-style capitalization.

github-actions · 2025-11-06T15:44:05Z

fern/products/docs/pages/resources/stainless-comparison-summary.mdx

+
+---
+
+## When to Choose Each


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Headings] 'When to Choose Each' should use sentence-style capitalization.

github-actions · 2025-11-06T15:44:05Z

fern/products/docs/pages/resources/stainless-comparison-summary.mdx

+
+## When to Choose Each
+
+### Choose Fern When:


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Headings] 'Choose Fern When:' should use sentence-style capitalization.

github-actions · 2025-11-06T15:44:05Z

fern/products/docs/pages/resources/stainless-comparison-summary.mdx

+## When to Choose Each
+
+### Choose Fern When:
+- ✅ Enterprise requirements (RBAC, SSO, versioning)


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

github-actions · 2025-11-06T15:44:05Z

fern/products/docs/pages/resources/stainless-comparison-summary.mdx

+- ✅ Large-scale documentation (100+ pages)
+- ✅ Multi-product or multi-version APIs
+
+### Choose Stainless When:


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Headings] 'Choose Stainless When:' should use sentence-style capitalization.

github-actions · 2025-11-06T15:44:05Z

fern/products/docs/pages/resources/stainless-comparison-summary.mdx

+
+---
+
+## Key Links


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Headings] 'Key Links' should use sentence-style capitalization.

github-actions · 2025-11-06T15:44:37Z

🌿 Preview your docs: https://fern-preview-bd9a6768-ef54-4094-9b40-e61f05108c40.docs.buildwithfern.com/learn

- Use sentence-style capitalization for all headings - Replace 'Visual Editor' with 'Fern Editor' - Replace 'Cannot' with 'can't' for contractions Co-Authored-By: Chris McDonnell <chris@buildwithfern.com>

github-actions

Remaining comments which cannot be posted as a review comment to avoid GitHub Rate Limit

vale

github-actions · 2025-11-06T15:48:35Z

fern/products/docs/pages/resources/stainless-comparison-summary.mdx

+- **Fern**: First-class versioning with availability states
+- **Impact**: Can't maintain multiple API versions simultaneously
+
+### 5. Interactive API explorer ❌


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

github-actions · 2025-11-06T15:48:35Z

fern/products/docs/pages/resources/stainless-comparison-summary.mdx

+- **Fern**: OpenAPI, AsyncAPI, gRPC, OpenRPC, Fern spec
+- **Impact**: Limited to REST APIs, no event-driven or RPC support
+
+### 10. Advanced redirects & SEO ❌


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Headings] '10. Advanced redirects & SEO ❌' should use sentence-style capitalization.

github-actions · 2025-11-06T15:48:36Z

fern/products/docs/pages/resources/stainless-comparison-summary.mdx

+- ✅ Large-scale documentation (100+ pages)
+- ✅ Multi-product or multi-version APIs
+
+### Choose Stainless when:


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Headings] 'Choose Stainless when:' should use sentence-style capitalization.

github-actions · 2025-11-06T15:48:36Z

fern/products/docs/pages/resources/stainless-comparison-summary.mdx

+
+**Fern Docs** is the enterprise-ready choice with production stability, comprehensive features, and robust infrastructure. **Stainless Docs** shows promise but remains in early access with critical feature gaps for enterprise deployments.
+
+For organizations evaluating documentation platforms today, Fern provides the maturity, features, and support required for mission-critical API documentation.


⚠️ [vale] _{reported by reviewdog 🐶}
[FernStyles.Current] Avoid time-relative terms like 'today' that become outdated

github-actions · 2025-11-06T15:48:36Z

fern/products/docs/pages/resources/stainless-comparison-full.mdx

+description: Comprehensive enterprise feature comparison between Stainless Docs and Fern Docs platforms
+---
+
+# Stainless Docs vs Fern Docs: Enterprise Feature Comparison


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Headings] 'Stainless Docs vs Fern Docs: Enterprise Feature Comparison' should use sentence-style capitalization.

github-actions · 2025-11-06T15:48:38Z

fern/products/docs/pages/resources/stainless-comparison-full.mdx

+- **Analytics** identify documentation gaps based on unanswered questions
+- **MCP server** enables AI coding assistants to access your docs programmatically
+
+Stainless offers basic RAG search without the operational controls needed for enterprise deployments where answer accuracy and compliance are critical.


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

github-actions · 2025-11-06T15:48:38Z

fern/products/docs/pages/resources/stainless-comparison-full.mdx

+
+---
+
+### 6. Authentication and Security


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Headings] '6. Authentication and Security' should use sentence-style capitalization.

github-actions · 2025-11-06T15:48:38Z

fern/products/docs/pages/resources/stainless-comparison-full.mdx

+
+| Feature | Fern Docs | Stainless Docs |
+|---------|-----------|----------------|
+| **Enterprise SSO** | ✅ WorkOS (SAML/OIDC/SCIM) | ❌ Not documented |


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

github-actions · 2025-11-06T15:48:39Z

fern/products/docs/pages/resources/stainless-comparison-full.mdx

+
+| Feature | Fern Docs | Stainless Docs |
+|---------|-----------|----------------|
+| **Enterprise SSO** | ✅ WorkOS (SAML/OIDC/SCIM) | ❌ Not documented |


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

github-actions · 2025-11-06T15:48:39Z

fern/products/docs/pages/resources/stainless-comparison-full.mdx

+| **Enterprise SSO** | ✅ WorkOS (SAML/OIDC/SCIM) | ❌ Not documented |
+| **Role-Based Access** | ✅ Audience-based content gating | ❌ Not documented |
+| **Authenticated Pages** | ✅ Login-protected documentation | ❌ Not documented |
+| **API Key Management** | ✅ Auto-populate in explorer | ⚠️ API keys for Stainless service only |


🚫 [vale] _{reported by reviewdog 🐶}
[Microsoft.Auto] In general, don't hyphenate 'Auto-populate'.

github-actions · 2025-11-06T15:49:06Z

🌿 Preview your docs: https://fern-preview-3726613a-7e9f-4864-8bfa-5ff18f81d43e.docs.buildwithfern.com/learn

github-actions

Remaining comments which cannot be posted as a review comment to avoid GitHub Rate Limit

vale

fern/products/docs/pages/resources/stainless-comparison-full.mdx|352 col 5| [FernStyles.Headings] 'Migrating from Other Platforms to Fern' should use sentence-style capitalization.
fern/products/docs/pages/resources/stainless-comparison-full.mdx|357 col 34| [FernStyles.Reject] Use 'API Reference' instead of 'API reference'.
fern/products/docs/pages/resources/stainless-comparison-full.mdx|361 col 4| [FernStyles.Headings] 'Pricing Considerations' should use sentence-style capitalization.
fern/products/docs/pages/resources/stainless-comparison-full.mdx|366 col 81| [FernStyles.Acronyms] 'SLA' has no definition.
fern/products/docs/pages/resources/stainless-comparison-full.mdx|377 col 199| [FernStyles.Acronyms] 'SSO' has no definition.
fern/products/docs/pages/resources/stainless-comparison-full.mdx|381 col 52| [FernStyles.Current] Avoid time-relative terms like 'today' that become outdated
fern/products/docs/pages/resources/stainless-comparison-full.mdx|385 col 4| [FernStyles.Headings] 'Additional Resources' should use sentence-style capitalization.

github-actions · 2025-11-06T15:51:41Z

fern/products/docs/pages/resources/stainless-comparison-full.mdx

+- Fern WorkOS: https://buildwithfern.com/learn/docs/getting-started/how-fern-docs-work (WorkOS integration)
+- Stainless Auth: https://www.stainless.com/docs/docs-platform/advanced/stainless-authentication/ - Only API keys for their service
+
+**Gap Analysis:** Stainless's "authentication" refers to API keys for accessing their documentation generation service, not end-user authentication for viewing documentation. Fern's WorkOS integration provides enterprise SSO, enabling:


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

github-actions · 2025-11-06T15:51:41Z

fern/products/docs/pages/resources/stainless-comparison-full.mdx

+
+---
+
+### 7. Hosting and Deployment


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Headings] '7. Hosting and Deployment' should use sentence-style capitalization.

github-actions · 2025-11-06T15:51:41Z

fern/products/docs/pages/resources/stainless-comparison-full.mdx

+
+| Feature | Fern Docs | Stainless Docs |
+|---------|-----------|----------------|
+| **Cloud Hosting** | ✅ Vercel with AWS VPC backend | ✅ Cloudflare (default) |


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

github-actions · 2025-11-06T15:51:41Z

fern/products/docs/pages/resources/stainless-comparison-full.mdx

+
+| Feature | Fern Docs | Stainless Docs |
+|---------|-----------|----------------|
+| **Cloud Hosting** | ✅ Vercel with AWS VPC backend | ✅ Cloudflare (default) |


🚫 [vale] _{reported by reviewdog 🐶}
[Microsoft.Avoid] Don't use 'backend'. See the A-Z word list for details.

github-actions · 2025-11-06T15:51:41Z

fern/products/docs/pages/resources/stainless-comparison-full.mdx

+| **Object Storage** | ✅ S3/MinIO in self-hosted | ❌ Not applicable |
+| **Search Engine** | ✅ MeiliSearch in self-hosted | ❌ Not applicable |
+| **Custom Domains** | ✅ Full support | ✅ Full support |
+| **CDN Integration** | ✅ Cloudflare + Vercel Edge | ✅ Cloudflare |


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

github-actions · 2025-11-06T15:51:43Z

fern/products/docs/pages/resources/stainless-comparison-full.mdx

+## Use Case Recommendations
+
+### Choose Fern Docs When:
+1. **Enterprise Requirements**: You need RBAC, SSO, versioning, or multi-product documentation


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

github-actions · 2025-11-06T15:51:44Z

fern/products/docs/pages/resources/stainless-comparison-full.mdx

+5. **Advanced AI**: You need operational controls over AI answers (guidance docs, custom sources)
+6. **Large-Scale Sites**: You're managing complex documentation with hundreds of pages and redirects
+7. **Analytics-Driven**: You want data on documentation usage and content gaps
+8. **Multi-Spec Support**: You use AsyncAPI, gRPC, or OpenRPC in addition to OpenAPI


📝 [vale] _{reported by reviewdog 🐶}
[Microsoft.Wordiness] Consider using 'also' instead of 'in addition'.

github-actions · 2025-11-06T15:51:44Z

fern/products/docs/pages/resources/stainless-comparison-full.mdx

+9. **Production Stability**: You need a stable, battle-tested platform with backward compatibility
+10. **Comprehensive Support**: You want white-glove migration and ongoing support
+
+### Choose Stainless Docs When:


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Headings] 'Choose Stainless Docs When:' should use sentence-style capitalization.

github-actions · 2025-11-06T15:51:44Z

fern/products/docs/pages/resources/stainless-comparison-full.mdx

+1. **Early Adopter**: You're comfortable with early access software and breaking changes
+2. **Simple Documentation**: You have straightforward documentation needs without versioning or RBAC
+3. **Astro Expertise**: Your team prefers Astro and wants deep customization control
+4. **Static Hosting**: You only need static file hosting without backend services


🚫 [vale] _{reported by reviewdog 🐶}
[Microsoft.Avoid] Don't use 'backend'. See the A-Z word list for details.

github-actions · 2025-11-06T15:51:44Z

fern/products/docs/pages/resources/stainless-comparison-full.mdx

+
+---
+
+## Migration Considerations


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Headings] 'Migration Considerations' should use sentence-style capitalization.

github-actions · 2025-11-06T15:51:59Z

🌿 Preview your docs: https://fern-preview-40874ba9-5fc9-4ad9-9651-00703440ba37.docs.buildwithfern.com/learn

- Add CardGroup with icons for top 10 enterprise gaps in summary - Convert detailed feature sections to Accordions in full document - Add Info, Success, Warning, and Launch callouts throughout - Enhance key links section with Cards for better organization - Improve visual hierarchy and readability with collapsible sections - Make documents more digestible and scannable for sales engineering use Co-Authored-By: Chris McDonnell <chris@buildwithfern.com>

github-actions · 2025-11-06T16:00:42Z

🌿 Preview your docs: https://fern-preview-036df871-ad48-4233-8339-8d8e3283bbaf.docs.buildwithfern.com/learn

github-actions · 2025-11-06T16:01:57Z

fern/products/docs/pages/resources/stainless-comparison-summary.mdx

+    **Impact**: Developers must use external tools (Postman, curl)
+  </Card>
+
+  <Card title="6. Enterprise SSO" icon="key">


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

github-actions · 2025-11-06T16:01:57Z

fern/products/docs/pages/resources/stainless-comparison-summary.mdx

+  </Card>
+
+  <Card title="8. AI operational controls" icon="robot">
+    **Stainless**: Basic RAG search


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

github-actions · 2025-11-06T16:01:57Z

fern/products/docs/pages/resources/stainless-comparison-summary.mdx

+
+<AccordionGroup>
+  <Accordion title="Choose Fern when" defaultOpen={true}>
+    <Success>Enterprise requirements (RBAC, SSO, versioning)</Success>


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

github-actions · 2025-11-06T16:01:57Z

fern/products/docs/pages/resources/stainless-comparison-full.mdx

+
+</Accordion>
+
+<Accordion title="3. API reference and interactive testing">


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

github-actions · 2025-11-06T16:01:58Z

fern/products/docs/pages/resources/stainless-comparison-full.mdx

+- **Redirects**: Fern's redirect system can maintain URL compatibility
+- **Timeline**: Fern offers white-glove migration service for Enterprise customers
+
+### Migrating from Other Platforms to Fern


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Headings] 'Migrating from Other Platforms to Fern' should use sentence-style capitalization.

github-actions · 2025-11-06T16:01:58Z

fern/products/docs/pages/resources/stainless-comparison-full.mdx

+
+---
+
+## Pricing Considerations


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Headings] 'Pricing Considerations' should use sentence-style capitalization.

github-actions · 2025-11-06T16:01:58Z

fern/products/docs/pages/resources/stainless-comparison-full.mdx

+### Fern Docs
+- **Starter**: Free tier available
+- **Pro**: Usage-based pricing
+- **Enterprise**: Custom pricing with white-glove migration, dedicated support, SLA


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

github-actions · 2025-11-06T16:01:58Z

fern/products/docs/pages/resources/stainless-comparison-full.mdx

+## Conclusion
+
+<Launch>
+**Fern Docs is the clear choice for enterprise organizations** requiring production-ready documentation with advanced features like RBAC, versioning, interactive API testing, visual editing, enterprise SSO, and full-stack self-hosting. The platform's maturity, comprehensive feature set, and robust infrastructure make it suitable for mission-critical documentation at scale.


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

github-actions · 2025-11-06T16:01:58Z

fern/products/docs/pages/resources/stainless-comparison-full.mdx

+
+**Stainless Docs Platform shows promise** with its Astro-based architecture and SDK-native approach, but remains in early access with significant feature gaps for enterprise deployments. Organizations should wait for Stainless to reach production maturity before considering it for critical documentation needs.
+
+**For enterprises evaluating documentation platforms today**, Fern Docs provides the stability, features, and support required for successful API documentation programs.


⚠️ [vale] _{reported by reviewdog 🐶}
[FernStyles.Current] Avoid time-relative terms like 'today' that become outdated

github-actions · 2025-11-06T16:01:58Z

fern/products/docs/pages/resources/stainless-comparison-full.mdx

+
+---
+
+## Additional Resources


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Headings] 'Additional Resources' should use sentence-style capitalization.

github-actions · 2025-11-06T20:14:31Z

fern/products/docs/pages/resources/stainless-comparison.mdx

+|------------|------|-----------|
+| **Maturity** | Production-ready, stable APIs | Early access, breaking changes expected |
+| **Authoring** | [Visual editor](/learn/docs/writing-content/fern-editor) + Git | Git only |
+| **Enterprise features** | [RBAC](/learn/docs/authentication/rbac), [SSO](/learn/docs/authentication/sso), [versioning](/learn/docs/configuration/what-is-docs-yml) | None |


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

github-actions · 2025-11-06T20:14:31Z

fern/products/docs/pages/resources/stainless-comparison.mdx

+
+<Accordion title="API reference and interactive testing">
+
+Stainless does not provide an interactive testing environment. Fern's [API Explorer](/learn/docs/api-references/api-explorer/overview) enables in-browser endpoint testing with automatic credential injection.


🚫 [vale] _{reported by reviewdog 🐶}
[Microsoft.Contractions] Use 'doesn't' instead of 'does not'.

github-actions · 2025-11-06T20:14:31Z

fern/products/docs/pages/resources/stainless-comparison.mdx

+
+| Feature | Fern Docs | Stainless Docs |
+|---------|-----------|----------------|
+| **API explorer** | ✅ [Full playground](/learn/docs/api-references/api-explorer/overview) with [auto-populated credentials](/learn/docs/api-references/autopopulate-api-key), WebSocket, and audio streaming support | ❌ None |


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

github-actions · 2025-11-06T20:14:31Z

fern/products/docs/pages/resources/stainless-comparison.mdx

+
+| Feature | Fern Docs | Stainless Docs |
+|---------|-----------|----------------|
+| **API explorer** | ✅ [Full playground](/learn/docs/api-references/api-explorer/overview) with [auto-populated credentials](/learn/docs/api-references/autopopulate-api-key), WebSocket, and audio streaming support | ❌ None |


🚫 [vale] _{reported by reviewdog 🐶}
[Microsoft.Auto] In general, don't hyphenate 'auto-populated'.

github-actions · 2025-11-06T20:14:32Z

fern/products/docs/pages/resources/stainless-comparison.mdx

+
+<Accordion title="RBAC, versioning, and multi-product support">
+
+Stainless does not currently offer audience-specific content filtering, multi-version APIs, or unified multi-product sites. Fern provides [RBAC](/learn/docs/authentication/rbac) and [versioning](/learn/docs/configuration/what-is-docs-yml) capabilities for complex API portfolios.


🚫 [vale] _{reported by reviewdog 🐶}
[Microsoft.Contractions] Use 'doesn't' instead of 'does not'.

github-actions · 2025-11-06T20:14:36Z

fern/products/docs/pages/resources/stainless-comparison.mdx

+| Component | Fern Docs | Stainless Docs |
+|-----------|-----------|----------------|
+| **Frontend** | Next.js (React) with SSR/SSG | Astro (static site generator) |
+| **Backend** | Node.js/Express (FDR) on AWS VPC | Stainless API service |


🚫 [vale] _{reported by reviewdog 🐶}
[Microsoft.Avoid] Don't use 'Backend'. See the A-Z word list for details.

github-actions · 2025-11-06T20:14:36Z

fern/products/docs/pages/resources/stainless-comparison.mdx

+| Component | Fern Docs | Stainless Docs |
+|-----------|-----------|----------------|
+| **Frontend** | Next.js (React) with SSR/SSG | Astro (static site generator) |
+| **Backend** | Node.js/Express (FDR) on AWS VPC | Stainless API service |


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

github-actions · 2025-11-06T20:14:36Z

fern/products/docs/pages/resources/stainless-comparison.mdx

+| **Frontend** | Next.js (React) with SSR/SSG | Astro (static site generator) |
+| **Backend** | Node.js/Express (FDR) on AWS VPC | Stainless API service |
+| **Database** | PostgreSQL | Not applicable (static) |
+| **Cache** | Redis, Vercel KV (Upstash) | Cloudflare CDN |


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

github-actions · 2025-11-06T20:14:37Z

fern/products/docs/pages/resources/stainless-comparison.mdx

+| **Storage** | S3 (AWS/MinIO) | Not applicable (static) |
+| **Search** | Algolia, MeiliSearch (self-hosted) | Metadata-driven indexing |
+| **Vector database** | TurboPuffer | None |
+| **AI** | Bedrock, Claude, Cohere | RAG with LLM (provider not specified) |


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

github-actions · 2025-11-06T20:14:37Z

fern/products/docs/pages/resources/stainless-comparison.mdx

+| **Vector database** | TurboPuffer | None |
+| **AI** | Bedrock, Claude, Cohere | RAG with LLM (provider not specified) |
+| **Authentication** | WorkOS | API keys (for Stainless service) |
+| **CDN** | Cloudflare + Vercel Edge | Cloudflare |


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

github-actions · 2025-11-06T20:15:25Z

🌿 Preview your docs: https://fern-preview-063f739d-72c1-44c2-9b1e-f96ac5d758b8.docs.buildwithfern.com/learn

github-actions · 2025-11-06T20:21:59Z

fern/products/docs/pages/resources/stainless-comparison.mdx

+
+<Accordion title="RBAC, versioning, and multi-product support">
+
+Stainless doesn't currently offer audience-specific content filtering, multi-version APIs, or unified multi-product sites. Fern provides [RBAC](/learn/docs/authentication/rbac) and [versioning](/learn/docs/configuration/what-is-docs-yml) capabilities for complex API portfolios.


⚠️ [vale] _{reported by reviewdog 🐶}
[FernStyles.Current] Avoid time-relative terms like 'currently' that become outdated

github-actions · 2025-11-06T20:21:59Z

fern/products/docs/pages/resources/stainless-comparison.mdx

+
+<Accordion title="Redirects, SEO, and large-site operations">
+
+Stainless doesn't currently document redirect capabilities. Fern's [redirect system](/learn/docs/seo/redirects) supports pattern matching and hundreds of rules for content migrations and reorganization.


⚠️ [vale] _{reported by reviewdog 🐶}
[FernStyles.Current] Avoid time-relative terms like 'currently' that become outdated

github-actions · 2025-11-06T20:22:00Z

fern/products/docs/pages/resources/stainless-comparison.mdx

+
+<Accordion title="Analytics and observability">
+
+Stainless doesn't currently document built-in analytics capabilities. Fern provides [analytics integrations](/learn/docs/integrations/overview) for page visits, search queries, AI chat insights, and user journeys.


⚠️ [vale] _{reported by reviewdog 🐶}
[FernStyles.Current] Avoid time-relative terms like 'currently' that become outdated

github-actions · 2025-11-06T20:22:24Z

🌿 Preview your docs: https://fern-preview-c943671c-e2f8-4ee9-8d2e-4d44248f77aa.docs.buildwithfern.com/learn

github-actions bot reviewed Nov 6, 2025

View reviewed changes

fix(docs): address Vale linting issues in comparison summary

7fbc162

- Use sentence-style capitalization for all headings - Replace 'Visual Editor' with 'Fern Editor' - Replace 'Cannot' with 'can't' for contractions Co-Authored-By: Chris McDonnell <chris@buildwithfern.com>

github-actions bot reviewed Nov 6, 2025

View reviewed changes

Update slugs for stainless comparison pages

cce45eb

github-actions bot reviewed Nov 6, 2025

View reviewed changes

condense/clean up page

48715f1

github-actions bot reviewed Nov 6, 2025

View reviewed changes

vale fixes

d30e233

github-actions bot reviewed Nov 6, 2025

View reviewed changes

devalog approved these changes Nov 6, 2025

View reviewed changes

devalog merged commit 12cccb9 into main Nov 6, 2025
2 checks passed

devalog deleted the add-stainless-comparison-docs branch November 6, 2025 20:30


		## Top 10 Enterprise Gaps Where Stainless Falls Short

		### 1. Platform Maturity ⚠️


		Fern Docs is the enterprise-ready choice with production stability, comprehensive features, and robust infrastructure. Stainless Docs shows promise but remains in early access with critical feature gaps for enterprise deployments.

		For organizations evaluating documentation platforms today, Fern provides the maturity, features, and support required for mission-critical API documentation.


		</Accordion>

		<Accordion title="3. API reference and interactive testing">


		Stainless Docs Platform shows promise with its Astro-based architecture and SDK-native approach, but remains in early access with significant feature gaps for enterprise deployments. Organizations should wait for Stainless to reach production maturity before considering it for critical documentation needs.

		For enterprises evaluating documentation platforms today, Fern Docs provides the stability, features, and support required for successful API documentation programs.


		<Accordion title="API reference and interactive testing">

		Stainless does not provide an interactive testing environment. Fern's [API Explorer](/learn/docs/api-references/api-explorer/overview) enables in-browser endpoint testing with automatic credential injection.


		<Accordion title="RBAC, versioning, and multi-product support">

		Stainless does not currently offer audience-specific content filtering, multi-version APIs, or unified multi-product sites. Fern provides [RBAC](/learn/docs/authentication/rbac) and [versioning](/learn/docs/configuration/what-is-docs-yml) capabilities for complex API portfolios.


		<Accordion title="RBAC, versioning, and multi-product support">

		Stainless doesn't currently offer audience-specific content filtering, multi-version APIs, or unified multi-product sites. Fern provides [RBAC](/learn/docs/authentication/rbac) and [versioning](/learn/docs/configuration/what-is-docs-yml) capabilities for complex API portfolios.


		<Accordion title="Redirects, SEO, and large-site operations">

		Stainless doesn't currently document redirect capabilities. Fern's [redirect system](/learn/docs/seo/redirects) supports pattern matching and hundreds of rules for content migrations and reorganization.


		<Accordion title="Analytics and observability">

		Stainless doesn't currently document built-in analytics capabilities. Fern provides [analytics integrations](/learn/docs/integrations/overview) for page visits, search queries, AI chat insights, and user journeys.

feat(docs): add Stainless vs Fern comparison pages as hidden resources #1817

feat(docs): add Stainless vs Fern comparison pages as hidden resources #1817

Conversation

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

Uh oh!

Add Stainless vs Fern comparison pages with enhanced visual components

Summary

Review & Testing Checklist for Human

Test Plan

Notes

Uh oh!

devin-ai-integration bot commented Nov 6, 2025

🤖 Devin AI Engineer

Uh oh!

github-actions bot left a comment

Choose a reason for hiding this comment

Uh oh!

github-actions bot Nov 6, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Nov 6, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Nov 6, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Nov 6, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Nov 6, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Nov 6, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Nov 6, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Nov 6, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Nov 6, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Nov 6, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Nov 6, 2025

Uh oh!

github-actions bot left a comment

Choose a reason for hiding this comment

Uh oh!

github-actions bot Nov 6, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Nov 6, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Nov 6, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Nov 6, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Nov 6, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Nov 6, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Nov 6, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Nov 6, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Nov 6, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Nov 6, 2025

devin-ai-integration bot commented Nov 6, 2025 •

edited

Loading