docs: add tab variants documentation #1713
Merged
Conversation
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
- Add comprehensive documentation for the new tab variants feature - Include examples of basic usage, default variants, and all properties - Add use cases and comparison with regular tabs - Include permissions and feature flags examples - Add changelog entry for 2025-11-03 - Add navigation entry in docs.yml Co-Authored-By: Colton Berry <coltonsberry@gmail.com>
Contributor
Author
🤖 Devin AI EngineerI'll be helping with this pull request! Here's what you should know: ✅ I will automatically:
Note: I can only respond to comments from users who have write access to this repository. ⚙️ Control Options:
|
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
|
|
||
| Tab variants are particularly useful for: | ||
|
|
||
| - **Multiple API types**: Show REST, GraphQL, and gRPC documentation in the same tab |
Contributor
There was a problem hiding this comment.
📝 [vale] reported by reviewdog 🐶
[FernStyles.Acronyms] 'REST' has no definition.
|
|
||
| - **Multiple API types**: Show REST, GraphQL, and gRPC documentation in the same tab | ||
| - **User personas**: Provide different content for developers, product managers, and administrators | ||
| - **Implementation approaches**: Display different integration methods (SDK, REST API, CLI) |
Contributor
There was a problem hiding this comment.
📝 [vale] reported by reviewdog 🐶
[FernStyles.Acronyms] 'REST' has no definition.
|
|
||
| ## Variants vs. tabs | ||
|
|
||
| Use **variants** when you want to show different perspectives or approaches to the same content area. Use **tabs** when you want to organize completely different sections of your documentation (like separating guides from API reference). |
Contributor
There was a problem hiding this comment.
🚫 [vale] reported by reviewdog 🐶
[FernStyles.Reject] Use 'API Reference' instead of 'API reference'.
Contributor
Co-Authored-By: Colton Berry <coltonsberry@gmail.com>
Contributor
| Tab variants let you display different content variations within a single tab. This is useful for showing different user types, implementation approaches, or experience levels without creating separate tabs. | ||
|
|
||
| <Tip title="When to use variants vs. tabs"> | ||
| Use **variants** for different perspectives on the same content area (REST vs. GraphQL, beginner vs. advanced). Use **tabs** for completely different documentation sections (guides vs. API reference). |
Contributor
There was a problem hiding this comment.
📝 [vale] reported by reviewdog 🐶
[FernStyles.Acronyms] 'REST' has no definition.
| Tab variants let you display different content variations within a single tab. This is useful for showing different user types, implementation approaches, or experience levels without creating separate tabs. | ||
|
|
||
| <Tip title="When to use variants vs. tabs"> | ||
| Use **variants** for different perspectives on the same content area (REST vs. GraphQL, beginner vs. advanced). Use **tabs** for completely different documentation sections (guides vs. API reference). |
Contributor
There was a problem hiding this comment.
🚫 [vale] reported by reviewdog 🐶
[FernStyles.Reject] Use 'API Reference' instead of 'API reference'.
|
|
||
| Create multiple content variations within a single tab using the new variants feature. This allows you to show different perspectives, user types, or implementation approaches for the same topic without creating separate tabs. | ||
|
|
||
| You can now define variants for tabs with different layouts, titles, subtitles, and icons. Each variant can have its own navigation structure, and you can explicitly set which variant should be the default. |
Contributor
There was a problem hiding this comment.
[FernStyles.Current] Avoid time-relative terms like 'now' that become outdated
| Tab variants let you display different content variations within a single tab, and [support RBAC](/learn/docs/authentication/rbac). This is useful for showing different user types, implementation approaches, or experience levels without creating separate tabs. | ||
|
|
||
| <Tip title="When to use variants vs. tabs"> | ||
| Use **variants** for different perspectives on the same content area (REST vs. GraphQL, beginner vs. advanced). Use **tabs** for completely different documentation sections (guides vs. API Reference). |
Contributor
There was a problem hiding this comment.
📝 [vale] reported by reviewdog 🐶
[FernStyles.Acronyms] 'REST' has no definition.
Contributor
Contributor
devalog
approved these changes
Nov 4, 2025
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
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.
Document tab variants feature
Summary
Added comprehensive documentation for the new tab variants feature introduced in CLI v0.100.0. Tab variants allow users to create multiple content variations within a single tab, useful for showing different user perspectives (developers vs. product managers), API types (REST vs. GraphQL), or experience levels (beginner vs. advanced) without creating separate tabs.
Changes:
fern/products/docs/pages/navigation/tab-variants.mdxfern/products/docs/pages/changelog/2025-11-03.mdxfern/products/docs/docs.ymlto include the new pageReview & Testing Checklist for Human
docs.ymlfile to ensure they work correctly and don't have syntax errors/learn/docs/configuration/tab-variantsand/learn/docs/authentication/rbacresolve correctly in the preview deploymentdefaultproperty and variant properties) against the actual implementation to ensure everything is accurateTest Plan
docs.ymlfileNotes
Devin Session: https://app.devin.ai/sessions/b6ddde8cfee748ce9466509fe8592982
Requested by: Colton Berry (colton@buildwithfern.com, @coltondotio)