docs: expand availability tags from 6 to 17 values#4324
docs: expand availability tags from 6 to 17 values#4324devin-ai-integration[bot] wants to merge 1 commit intomainfrom
Conversation
Co-Authored-By: rishabh <rishabh@buildwithfern.com>
🤖 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}
|
|
||
| ## Expanded availability tags | ||
|
|
||
| You can now use 17 availability tags for pages, sections, folders, and API reference endpoints. In addition to the original 6 values (`stable`, `generally-available`, `in-development`, `pre-release`, `deprecated`, `beta`), the following are now supported: |
There was a problem hiding this comment.
[FernStyles.Current] Avoid time-relative terms like 'now' that become outdated
|
|
||
| ## Expanded availability tags | ||
|
|
||
| You can now use 17 availability tags for pages, sections, folders, and API reference endpoints. In addition to the original 6 values (`stable`, `generally-available`, `in-development`, `pre-release`, `deprecated`, `beta`), the following are now supported: |
There was a problem hiding this comment.
🚫 [vale] reported by reviewdog 🐶
[FernStyles.Reject] Use 'API Reference' instead of 'API reference'.
|
|
||
| ## Expanded availability tags | ||
|
|
||
| You can now use 17 availability tags for pages, sections, folders, and API reference endpoints. In addition to the original 6 values (`stable`, `generally-available`, `in-development`, `pre-release`, `deprecated`, `beta`), the following are now supported: |
There was a problem hiding this comment.
📝 [vale] reported by reviewdog 🐶
[Microsoft.Wordiness] Consider using 'also' instead of 'In addition'.
|
|
||
| ## Expanded availability tags | ||
|
|
||
| You can now use 17 availability tags for pages, sections, folders, and API reference endpoints. In addition to the original 6 values (`stable`, `generally-available`, `in-development`, `pre-release`, `deprecated`, `beta`), the following are now supported: |
There was a problem hiding this comment.
[FernStyles.Current] Avoid time-relative terms like 'now' that become outdated
| @@ -1,4 +1,4 @@ | |||
| You can set the availability for the entire API reference or for specific sections in your `docs.yml` configuration. Options are: `stable`, `generally-available`, `in-development`, `pre-release`, `deprecated`, or `beta`. | |||
| You can set the availability for the entire API reference or for specific sections in your `docs.yml` configuration. Options are: `stable`, `generally-available`, `release-candidate`, `public-beta`, `beta`, `private-beta`, `limited-availability`, `canary-release`, `preview`, `pre-release`, `alpha`, `experimental`, `internal`, `in-development`, `sunset`, `deprecated`, or `retired`. | |||
There was a problem hiding this comment.
🚫 [vale] reported by reviewdog 🐶
[FernStyles.Reject] Use 'API Reference' instead of 'API reference'.
|
🌿 Preview your docs: https://fern-preview-9ac11548-d749-4e61-8483-6d8bb1310d64.docs.buildwithfern.com/learn Here are the markdown pages you've updated: |
Summary
Updates documentation to reflect the expanded set of availability tags (from 6 to 17). This is the docs-side companion to fern-api/fern-platform#8684 (FDR SDK/backend) and fern-api/fern#13631 (CLI).
Files changed:
navigation.mdx— updated inline availability options listfrontmatter.mdx— updated valid values description in<ParamField>snippets/availability.mdx— updated shared snippet used across API reference docschangelog/2026-03-17.mdx— new changelog entry documenting the 11 added tagsNew tags:
release-candidate,public-beta,private-beta,limited-availability,canary-release,preview,alpha,experimental,internal,sunset,retired.Review & Testing Checklist for Human
<Accordion>would be more scannable — the current format is quite dense.Notes
version-availability.mdxsnippet (for version-leveldeprecated/ga/stable/beta) was intentionally not changed — version availability is a separate, smaller enum.Plant API) per repo conventions.Link to Devin session: https://app.devin.ai/sessions/b659d40b9db14dc7a30abbb3785613b9