You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/updates-to-ember-data-versioning-strategy.md
+13-13Lines changed: 13 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,24 +15,24 @@ tags:
15
15
Today the EmberData team is excited to announce changes to how we manage lockstep
16
16
versioning with the broader Ember.js project.
17
17
18
-
The primary goals of these changes is to improve version-to-version stability for our consumers. We see this being beneficial in several ways.
18
+
The primary goal of these changes is to improve version-to-version stability for our consumers. We see this being beneficial in several ways.
19
19
20
-
First, by releasing fewer versions that contain no effective changes other than the version bump. We believe this will help consumers navigate version-by-version and lts-by-lts upgrades with greater stability and clarity.
20
+
First, by releasing fewer versions that contain no effective changes other than the version bump. We believe this will help consumers navigate version-by-version and LTS-by-LTS upgrades with greater stability and clarity.
21
21
22
-
Second, if the only changes are bugfixes then these fixes are applied to the latest minor
22
+
Second, if the only changes are bug fixes then these fixes are applied to the latest minor
23
23
instead of becoming strung out across multiple minors.
24
24
25
25
Third, this should enable the project to move more carefully at times when more substantive changes
26
26
are being made.
27
27
28
-
Our hope is that this new policy will improve the ability for us to invest in upgrade paths for
28
+
We hope that this new policy will improve the ability for us to invest in upgrade paths for
29
29
consumers using older versions by focusing on providing the most robust release targets we can.
30
30
31
31
## Policy Changes
32
32
33
33
- When Ember.js releases an LTS, the most recent release of EmberData will also be released as an LTS.
34
34
- When Ember.js releases a new major, EmberData will also release a new major.
35
-
- New minor releases of EmberData will coincide with Ember.js' sixweek release cadence when EmberData releases a new minor.
35
+
- New minor releases of EmberData will coincide with Ember.js' six-week release cadence when EmberData releases a new minor.
36
36
- These changes do not affect how and when ember-source and ember-cli release.
37
37
- These changes do not change EmberData's LTS support policy or its ember-source LTS support policy.
38
38
@@ -42,21 +42,21 @@ consumers using older versions by focusing on providing the most robust release
42
42
43
43
- The API Docs will continue to function as expected except that when viewing docs for EmberData the version dropdown will only include versions available for EmberData. Additionally, linking from places in the EmberData API docs to the Ember API docs will take you to the matching version number of Ember - not necessarily the most recently released version of Ember.
44
44
- EmberData's README has added a compatibility table.
45
-
- New releases (including patch and lts releases) of EmberData beginning today will always list the range of compatible ember-source versions in the release notes at time of release
46
-
- EmberData will begin setting an explicit peerDependency on ember-source set to all tested compatible versions matching the range specified in the release notes
45
+
- New releases (including patch and lts releases) of EmberData beginning today will always list the range of compatible ember-source versions in the release notes at the time of release.
46
+
- EmberData will begin setting an explicit peerDependency on ember-source set to all tested compatible versions matching the range specified in the release notes.
47
47
48
48
- Note: this peerDependency will at times be much broader than EmberData's official LTS support policy of "last 2 ember-source LTS releases".
49
-
- ember-cli will ship the latest version of EmberData at times of release in the new app blueprint.
49
+
- ember-cli will ship the latest version of EmberData at the time of releases in the new app blueprint.
50
50
- The releases overview on the website will continue to offer instructions for installing the latest version of Ember.js, which will include the latest version of EmberData (see previous bullet point). The LTS page will be updated to track both the Ember.js and EmberData LTS.
51
51
52
52
## Examples
53
53
54
-
- ember-source releases a new minor (5.4), EmberData chooses to not release and remains at 5.3
55
-
- ember-source releases a new LTS (5.4), EmberData's latest release is 5.3 and thus releases 5.3 as LTS
56
-
- ember-source releases a new minor (5.5), EmberData chooses to release and thus bumps from 5.3 to 5.4
57
-
- ember-source releases a new major (6.0), EmberData will release 6.0
54
+
- ember-source releases a new minor (5.4), EmberData chooses to not release and remains at 5.3.
55
+
- ember-source releases a new LTS (5.4), EmberData's latest release is 5.3 and thus releases 5.3 as LTS.
56
+
- ember-source releases a new minor (5.5), EmberData chooses to release and thus bumps from 5.3 to 5.4.
57
+
- ember-source releases a new major (6.0), EmberData will release 6.0.
58
58
59
59
## Timeline
60
60
61
61
EmberData is beginning this new policy effective with the current release, and has opted to not
62
-
release in this cycle. Thus the latest ember-source is 5.4 and latest ember-data is 5.3
62
+
release in this cycle. Thus the latest ember-source is 5.4 and latest ember-data is 5.3.
0 commit comments