Skip to content

Commit 12c211c

Browse files
author
Aleksandar
authored
Merge pull request #503 from react-native-community/rn-versions-lifecycle-support
RFC: React Native Versions Lifecycle & Support
2 parents 5324ef5 + 322a743 commit 12c211c

File tree

1 file changed

+69
-0
lines changed

1 file changed

+69
-0
lines changed
Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
# RFC: React Native Versions Lifecycle & Support
2+
3+
4+
5+
>As we are finding ways to better support React Native community, we are moving towards supporting a limited amount of versions of React Native better.
6+
7+
8+
The React Native Core team is working to strike a balance between the speed of innovation with the amount of regular change to the platform. We understand that each release brings new value and has an adoption cost to the community.
9+
This document describes how we intend to formally balance these concerns and provide clear and consistent support over time.
10+
React Native team will work on best-effort basis to release a new version of React Native every four months. And will focus on speeding up the release cycle and put considerable effort into ensuring a seamless upgrade path.
11+
This document describes the level of support we can provide and which set of versions is supported.
12+
13+
## Glossary
14+
15+
Below we are defining terms used in this document:
16+
17+
* **stable** **version** - Any version that doesn’t have a -alpha, -beta, -RC postfix in the version name.
18+
* **latest version** - **** The latest stable version with the highest version number (e.g. 0.68.2).
19+
* The highest version number is defined following the [NPM server algorithm](https://github.com/npm/node-semver).
20+
* **next version** - The next version that hasn’t been fully released yet, and is currently in development/testing (e.g. 0.69.0-RC1).
21+
* **minor series** - A collection of versions (either stable or not stable) sharing the same minor version (e.g. **0.68**.0-RC0, **0.68**.0, **0.68**.1 are all part of the **0.68** minor series).
22+
23+
## Which versions are currently supported?
24+
25+
We’re supporting the **latest** **version**, and the latest versions from the **two previous minor series.**
26+
We’re also supporting the **next version,** having in mind this is the not yet stable version we are developing at that moment in time.
27+
28+
Versions:
29+
30+
31+
|Version |Type |Status |
32+
|--- |--- |--- |
33+
|0.70.0-RC2 |Release candidate |Will be in support when stabilized |
34+
|0.69.4 |Latest stable |In support |
35+
|0.68.3 |Previous minor series |In support |
36+
|0.67.4 |Previous minor series |In support |
37+
|<=0.66.3 |Old minor series |Unsupported |
38+
39+
## What is the level of support?
40+
41+
Due to support bandwidth, the React Native team, with the community's help, is looking into issues & PRs opened against one of the supported versions.
42+
43+
Issues & PRs opened against older versions would be considered only in exceptional cases. Please update your application to one of the supported versions and raise the Issue/PR targeted to that version.
44+
45+
Issues should contain a [**reproducer**](https://stackoverflow.com/help/minimal-reproducible-example) project regardless of which version they targeting, for them to be considered.
46+
Issues without a reproducer will require more effort to understand and fix, and are less likely to receive attention.
47+
48+
At this point in time, we are prioritizing issues that are related to:
49+
50+
* Latest version of React Native and two previous minor series.
51+
* Use of the New Architecture
52+
* Use of the Hermes Engine
53+
54+
## Cherry-Pick Requests
55+
56+
We’re **accepting cherry-pick requests** for the currently supported versions. A cherry-pick request is the request to include a fix in one of the supported versions and release a new point release with it.
57+
58+
Cherry-Pick requests should be submitted via the [React Native Releases Working Group](https://github.com/reactwg/react-native-releases/discussions/categories/patches), in the corresponding discussion thread.
59+
60+
Please note that each cherry-pick request will be assessed and approved individually. Cherry-Pick requests against unsupported versions will be rejected unless they’re involving security issues.
61+
62+
## Security Issues
63+
64+
Security issues should follow our issue report policy [described here](https://github.com/facebook/react-native/blob/main/CONTRIBUTING.md#security-bugs)
65+
66+
67+
## Licence
68+
69+
React Native is open-source software distributed under the **MIT license**. Software is provided "as is" without warranty.

0 commit comments

Comments
 (0)