Skip to content

docs: add alpha, preview, and stable as availability options for x-fern-availability#3244

Open
devin-ai-integration[bot] wants to merge 2 commits intomainfrom
devin/1769186328-add-alpha-preview-availability-docs
Open

docs: add alpha, preview, and stable as availability options for x-fern-availability#3244
devin-ai-integration[bot] wants to merge 2 commits intomainfrom
devin/1769186328-add-alpha-preview-availability-docs

Conversation

@devin-ai-integration
Copy link
Contributor

@devin-ai-integration devin-ai-integration bot commented Jan 23, 2026

Summary

Updates the x-fern-availability OpenAPI extension documentation to include new availability options. Also adds clarifying notes about how each option maps to internal availability statuses.

New options:

  • alpha → maps to in-development
  • preview → maps to pre-release (same as beta)
  • stable → maps to generally-available (same as ga)

This is a companion PR to fern-api/fern#11713 which implements the actual parsing logic.

Review & Testing Checklist for Human

  • Verify the mapping descriptions are accurate (alpha → in-development, beta/preview → pre-release, stable → generally-available)
  • Confirm the fern repo PR is merged before merging this docs PR
  • Check the preview link to verify the rendered documentation looks correct

Notes

Link to Devin run: https://app.devin.ai/sessions/5732bfb11d0849959b0fcb3cc3abe788
Requested by: Niels Swimberghe (@Swimburger)

…bility

Co-Authored-By: Niels Swimberghe <3382717+Swimburger@users.noreply.github.com>
@devin-ai-integration
Copy link
Contributor Author

🤖 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
Copy link
Contributor

Co-Authored-By: Niels Swimberghe <3382717+Swimburger@users.noreply.github.com>
- `beta` (maps to pre-release)
- `preview` (maps to pre-release)
- `generally-available`
- `stable` (maps to generally-available)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] reported by reviewdog 🐶
[FernStyles.Hyphens] 'generally-available' doesn't need a hyphen.

- `beta` (maps to pre-release)
- `preview` (maps to pre-release)
- `generally-available`
- `stable` (maps to generally-available)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

@devin-ai-integration devin-ai-integration bot changed the title docs: add alpha and preview as availability options for x-fern-availability docs: add alpha, preview, and stable as availability options for x-fern-availability Jan 23, 2026
@github-actions
Copy link
Contributor

@github-actions
Copy link
Contributor

This PR is stale because it has been open 25 days with no activity. Remove stale label or comment or this will be closed in 5 days.

@github-actions github-actions bot added the Stale This PR hasn't has any commits or comments in 25 days or more. label Feb 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Stale This PR hasn't has any commits or comments in 25 days or more.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants

Comments