Skip to content

Commit 5d787fd

Browse files
authored
Add docs on unstable release process (#13015)
1 parent 6086294 commit 5d787fd

File tree

2 files changed

+13
-0
lines changed

2 files changed

+13
-0
lines changed

docs/community/api-development-strategy.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,8 @@ Unstable flags are not recommended for production:
3030

3131
When you opt-in to an unstable flag you are becoming a contributor to the project, rather than a user. We appreciate your help, but please be aware of the new role!
3232

33+
Because unstable flags are experimental and not guaranteed to stick around, we ship them in SemVer patch releases because they're not new _stable_/_documented_ APIs. When an unstable flag stabilizes into a Future Flag, that will be released in a SemVer minor release and will be properly documented and added to the [Future Flags Guide](../upgrading/future).
34+
3335
To learn about current unstable flags, keep an eye on the [CHANGELOG](../start/changelog).
3436

3537
### Example New Feature Flow

docs/upgrading/future.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
---
2+
title: Future Flags
3+
---
4+
5+
# Future Flags and Deprecations
6+
7+
This guide walks you through the process of adopting future flags in your React Router app. By following this strategy, you will be able to upgrade to the next major version of React Router with minimal changes. To read more about future flags see [API Development Strategy](../community/api-development-strategy).
8+
9+
We highly recommend you make a commit after each step and ship it instead of doing everything all at once. Most flags can be adopted in any order, with exceptions noted below.
10+
11+
<docs-warning>**There are no current future flags in React Router v7**</docs-warning>

0 commit comments

Comments
 (0)