Skip to content

Commit f9fc1f9

Browse files
committed
adopt React's versioning scheme
closes #3102
1 parent 7989ca4 commit f9fc1f9

File tree

1 file changed

+1
-20
lines changed

1 file changed

+1
-20
lines changed

README.md

Lines changed: 1 addition & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -125,26 +125,7 @@ See more in the [Introduction](https://github.com/reactjs/react-router/tree/late
125125

126126
### Versioning and Stability
127127

128-
React Router follows semver to the best of our interpretation of it. We want React Router to be a stable dependency that’s easy to keep current. Here is our upgrading strategy for your apps.
129-
130-
Assuming you are currently on version 1.0:
131-
132-
1. 2.0 is fully backward compatible with 1.0 so you can upgrade, and then update your code incrementally.
133-
2. All deprecated 1.0 API usage warns to the console and links to an upgrade guide.
134-
3. 3.0 will remove 1.0 deprecations completely.
135-
4. 3.0 will be released no sooner than three months after 2.0. This gives an API, in the worst case scenario, six months of life if you’re staying perfectly up-to-date.
136-
5. Some codemods that will automatically update your code will be available at reactjs/rackt-codemod
137-
138-
> If it’s fully backwards compatible, why isn’t that a minor release?
139-
140-
If we didn’t provide the backwards compatibility then you wouldn’t be asking this question — but then upgrading would break your app. We don’t want to break your app, we want smooth, incremental upgrades.
141-
142-
In practice, this means you can:
143-
144-
1. Upgrade from 1.0 to 2.0 and your app will still run.
145-
2. Update your code incrementally to the new API, and you have three months before the next release to do it.
146-
3. Run the codemods to make some of (2) automatic.
147-
4. If your code runs without warnings, you can repeat this list with version 3.0
128+
We want React Router to be a stable dependency that’s easy to keep current. We follow the same versioning as React.js itself: [React Versioning Scheme](https://facebook.github.io/react/blog/2016/02/19/new-versioning-scheme.html).
148129

149130
### Thanks
150131

0 commit comments

Comments
 (0)