Document 4.x to 5.x migration

I have looked through the releases for comments, looked for CHANGELOG.md in source (looks like there was one once upon a time, but it is gone now), scanned commit messages for clues, looked for 4.x -> 5.x migration notes on doc site, etc. but did not find anything. I suspect that I am not the only one who would really like to be able to easily determine what significant/breaking changes have been introduced in 5.x. Would someone please help document this?

git log --abbrev-commit --oneline v4.4.0..v5.0.6:

commit summaries

586300a 5.0.6
54d0e58 fix: Only throw missing Intl.RelativeTimeFormat exception when API is used. (#1272)
26da85c chore(docs): Change brand theme color.
f7ff38b chore(docs): Fix overflowing issues when scrollbars are visible.
cf283fd chore(docs): Remove reference to installing @next tag of ember-intl
b0792bc 5.0.5
763b94a chore: Bump dependencies. (#1271)
24f5c98 chore(docs): Rewrites runtime requirements, add browser matrix, polyfills intl-pluralrules (#1270)
a0e6906 chore(docs): Remove browser support section in runtime requirements.
a2dd6d9 chore(docs): yarn install -> yarn add.
2c2c14c chore(docs): s/react/ember.
cbb0715 chore: fix tests-node unit tests.
c29895b 5.0.4
26eac0f fix(docs): polyfill docs with intl.relativetimeformat polyfill to support Safari 13. (#1269)
0f7036d fix: mark error-types as @private and @hide until the public API for onError is enabled.
80998fb 5.0.3
4480cd6 fix: Adds obsolete warnings for autoPolyfill, disablePolyfill, and locales.
9aa09e7 chore(docs): Include autoPolyfill option in obsolete section of migration doc
61333c0 5.0.2
ea73526 chore: Removes lodash.get. (#1266)
ad29eb6 chore: Update link to 4.4.0 docs in README.
55ee0a3 chore: Update README links to docs.
8a3cbf7 5.0.1
9c355d6 chore: Removes use of Ember.assign polyfill (#1265)
8a83ccb chore: Document node 8 drop in migration from 4.0 to 5.0 doc.
6503b4d feat: Adds hourCycle formatter option to format-time and format-date (#1264)
0f97fe2 build(deps-dev): Bump lint-staged from 10.2.1 to 10.2.2
8119084 build(deps-dev): Bump lint-staged from 10.2.0 to 10.2.1
eff24a8 build(deps): [Security] Bump jquery from 3.4.1 to 3.5.0 (#1259)
25bc588 build(deps-dev): Bump lint-staged from 10.1.7 to 10.2.0
e6ff7d4 build(deps): Bump intl-messageformat from 8.3.8 to 8.3.9
3309939 build(deps): Bump intl-messageformat-parser from 5.0.1 to 5.0.2
9daa0ce (fix): Breaking test cases for nested translations (#1252)
3aeaa6c build(deps-dev): Bump mocha from 7.1.1 to 7.1.2
780b8a4 build(deps): Bump intl-messageformat from 8.3.7 to 8.3.8
c909a5a build(deps-dev): Bump lint-staged from 10.1.6 to 10.1.7
98674e7 build(deps-dev): Bump eslint-config-prettier from 6.10.1 to 6.11.0
ecce8c2 build(deps-dev): Bump prettier from 2.0.4 to 2.0.5
97ce7a7 build(deps): Bump intl-messageformat-parser from 4.1.4 to 5.0.0 (#1247)
423ea37 build(deps): Bump intl-messageformat from 8.3.6 to 8.3.7
0fc48b6 build(deps-dev): Bump lint-staged from 10.1.5 to 10.1.6
25ee49e build(deps-dev): Bump lint-staged from 10.1.4 to 10.1.5
29a0f73 build(deps-dev): Bump lint-staged from 10.1.3 to 10.1.4
03f7b00 build(deps-dev): Bump ember-source from 3.17.3 to 3.18.0
044ecb0 build(deps-dev): Bump ember-resolver from 7.0.0 to 8.0.0
6ec3980 build(deps-dev): Bump eslint-plugin-prettier from 3.1.2 to 3.1.3
7cb50a1 build(deps): Bump intl-messageformat from 8.3.5 to 8.3.6
9381ff0 build(deps): Bump intl-messageformat-parser from 4.1.3 to 4.1.4
9cf604a build(deps): Bump intl-messageformat from 8.3.2 to 8.3.5
e62dbcf build(deps): Bump intl-messageformat-parser from 4.1.1 to 4.1.3
44c39d0 5.0.0-beta.1
75e6261 Move webpack configuration into dummy application (#1230)
035eb66 build(deps-dev): Bump qunit-dom from 1.1.0 to 1.2.0
6248324 fix: only warn on ICU mismatch if key & locale not already reported for missing translation
683bb75 build(deps-dev): Bump ember-cli-htmlbars from 4.3.0 to 4.3.1
fca68d3 build(deps-dev): Bump lint-staged from 10.1.2 to 10.1.3
ca24464 build(deps-dev): Bump ember-cli-htmlbars from 4.2.3 to 4.3.0
a7d9583 build(deps-dev): Bump prettier from 2.0.3 to 2.0.4
0618390 chore: start at doc links at quickstart for each version.
97c9e83 chore: move installation to docs.
64b92fa release: 5.0.0@next
86fb010 chore: refactoring linter into own module. (#1222)
4e785c7 build(deps-dev): Bump prettier from 2.0.2 to 2.0.3
b582a7f build(deps-dev): Bump lint-staged from 10.1.1 to 10.1.2
791068b chore: mark flatten utility fn as private/hidden.
bae89e8 feat: translations written and read from fixed module location. (#1219)
042f464 chore: remove deprecated option.
a9426c9 chore: (BREAKING) removes supporting dasherized filter options.
6678ba8 Merge branch 'master' of github.com:jasonmit/ember-intl
633490f chore: regenerate yarn.lockfile for security updates.
a66560d build(deps): Bump mkdirp from 1.0.3 to 1.0.4
c4438e5 build(deps-dev): Bump ember-source from 3.17.2 to 3.17.3
901e128 chore: linting.
e8cbb93 build(deps-dev): Bump lint-staged from 10.1.0 to 10.1.1 (#1215)
9ffa748 Clarify that SafeStrings are not escaped (#1214)
3df16d4 build(deps): Bump broccoli-merge-trees from 4.1.0 to 4.2.0 (#1213)
8d7d396 build(deps-dev): Bump lint-staged from 10.0.10 to 10.1.0
33333e2 build(deps-dev): Bump lint-staged from 10.0.9 to 10.0.10
34b29dc build(deps): Bump ember-cli-babel from 7.18.0 to 7.19.0 (#1209)
4381673 build(deps-dev): Bump ember-source from 3.17.1 to 3.17.2
a2fa20b chore: linting
84350df Update -base.js
efc4ef2 chore: renaming variable to reflect new api
904b6c1 build(deps-dev): Bump eslint-plugin-ember from 7.12.0 to 7.13.0
ea7b5db build(deps-dev): Bump eslint-plugin-node from 11.0.0 to 11.1.0
280b945 chore: remove dead fn, further clean up formatter logic.
4d0b806 chore: refactoring formatters, updates formatter options.
03c6c9d feat: updates formatters, introduces onError fn. (#1200)
631b699 chore: rename private methods.
fdbacb2 chore: move private fields under public fields.
a1e73ea feat: parse translations as they're pushed to translation store (#1199)
8c9f959 chore: move flatten into utility fn.
fc4f4a1 chore: consolidate two methods in new translation container api.
c8e9c0f chore: no longer store instances of the translations in the Ember container. (#1198)
7d090bb build(deps): Bump intl-messageformat from 8.3.1 to 8.3.2
72bbc3b build(deps-dev): Bump eslint-plugin-ember from 7.11.1 to 7.12.0
77c4048 build(deps): Bump intl-messageformat from 8.2.3 to 8.3.1 (#1194)
c964c9c chore: more README polish.
86a8cfa chore: more README polish.
c5d61e0 chore: more README polish.
7a445d7 chore: update docs to reflect new relative time API.
f468e86 chore: fix broken ICU link in README
4a03325 chore: updating LICENSE.
70645d7 chore: privatizes more utilities and private methods. (#1192)
c63225c chore: Adding start of 4.0 to 5.0 migration doc. (#1191)
8b0e39c chore: remove intljs polyfill references since references in runtime requirements.
f76d77b Update README.md
a6ec0d2 Update README.md
9929e3e Update README.md
5ea5298 feat(BREAKING): removes config.locales option. (#1190)
667f641 chore: adds single quote escape test.
4b5e057 feat(BREAKING): upgrades parser, compiler, migrates to native intl.relativetime (#1186)
f0b7a61 build(deps-dev): Bump eslint-plugin-ember from 7.11.0 to 7.11.1
07286de feat: intl macro no longer marked as readOnly. (#1184)
9fdca1a chore: formatting based on new prettier release.
7418b57 chore: bumping dependencies, dropping Node 8
ca9a57f build(deps-dev): Bump eslint-plugin-ember from 7.10.1 to 7.11.0 (#1172)
f776201 build(deps-dev): Bump eslint-config-prettier from 6.10.0 to 6.10.1 (#1175)
f414aed chore: formatting based on new prettier release.
400ee41 build(deps-dev): Bump prettier from 1.19.1 to 2.0.2 (#1177)
aef84d1 Append context to ICU parsing failure (#1179)
377bc3d build(deps-dev): Bump lint-staged from 10.0.8 to 10.0.9
d0aa31a build(deps-dev): Bump ember-source from 3.17.0 to 3.17.1
50367b6 build(deps-dev): Bump mocha from 7.1.0 to 7.1.1
cc85eab build(deps-dev): Bump testdouble from 3.13.0 to 3.13.1
cd34820 build(deps-dev): Bump ember-cli from 3.16.1 to 3.17.0
fa99f41 build(deps-dev): Bump ember-cli from 3.16.0 to 3.16.1
c6ab6c1 build(deps-dev): Bump eslint-plugin-ember from 7.10.0 to 7.10.1
9eb3b85 build(deps-dev): Bump eslint-plugin-ember from 7.9.0 to 7.10.0
dd3e2bf build(deps-dev): Bump ember-source from 3.16.3 to 3.17.0
7299c15 build(deps-dev): Bump qunit-dom from 1.0.0 to 1.1.0
7d3c4e8 build(deps): Bump fast-memoize from 2.5.1 to 2.5.2
2489866 build(deps-dev): Bump eslint-plugin-ember from 7.8.1 to 7.9.0
3c42967 build(deps-dev): Bump testdouble from 3.12.5 to 3.13.0
0f19354 build(deps-dev): Bump mocha from 7.0.1 to 7.1.0
473cb88 fix: change tree cache to support engines tested with dummy apps (#1152)
44305fa build(deps-dev): Bump lint-staged from 10.0.7 to 10.0.8
a5831e2 build(deps-dev): Bump babel-eslint from 10.0.3 to 10.1.0
ffc714a build(deps-dev): Bump ember-cli-htmlbars from 4.2.2 to 4.2.3
d048707 build(deps): Bump broccoli-funnel from 3.0.1 to 3.0.2
70442d0 build(deps-dev): Bump ember-source from 3.16.2 to 3.16.3
2c50754 build(deps): Bump @ember-intl/broccoli-cldr-data from 3.1.0 to 3.1.1
f5fc415 build(deps): Bump ember-cli-babel from 7.17.2 to 7.18.0 (#1143)
8e32c79 build(deps-dev): Bump eslint-plugin-ember from 7.7.2 to 7.8.1
a2501ab build(deps-dev): Bump ember-cli from 3.15.2 to 3.16.0
c88987f chore: linting whitespace
621115e chore: lint changes for new ember eslint plugin rules (#1145)
9c195b3 Language Server Addon information (#1139)
cf1da24 build(deps-dev): Bump ember-source from 3.16.1 to 3.16.2
5319403 build(deps): Bump ember-cli-babel from 7.14.1 to 7.17.2 (#1138)
2fffe42 build(deps-dev): Bump ember-source from 3.16.0 to 3.16.1
b2322b4 build(deps-dev): Bump qunit-dom from 0.9.2 to 1.0.0
9d128cf chore: Move to travis-ci.com from travis-ci.org
8fd1505 chore: fix deprecations and warnings in tests (#1127)
086b6d7 Merge pull request #1129 from ember-intl/dependabot/npm_and_yarn/ember-cli-babel-7.14.1
b324bbd chore(eslint): consolidate config within the root config (#1126)
ffbdd19 build(deps-dev): Bump lint-staged from 10.0.6 to 10.0.7
7081b9b build(deps): Bump ember-cli-babel from 7.13.2 to 7.14.1
e5fb5a5 build(deps-dev): Bump lint-staged from 10.0.5 to 10.0.6
18b94c7 build(deps-dev): Bump lint-staged from 10.0.4 to 10.0.5
62d8973 build(deps-dev): Bump lint-staged from 10.0.3 to 10.0.4
f3e3369 build(deps-dev): Bump eslint-config-prettier from 6.9.0 to 6.10.0
25ea0f6 fix: for using prototype methods as event callbacks (#1120)
0512b62 build(deps-dev): Bump lint-staged from 10.0.2 to 10.0.3
a8e1d1d build(deps-dev): Bump mocha from 7.0.0 to 7.0.1
89d3e22 build(deps): Bump broccoli-merge-trees from 3.0.2 to 4.1.0 (#1087)
8e82794 build(deps): Bump mkdirp from 0.5.1 to 1.0.3 (#1116)
7ef9bad build(deps): Bump broccoli-funnel from 2.0.2 to 3.0.0 (#1068)
e397223 chore: Drops support for Node 8 (#1117)
e7584fb build(deps-dev): Bump ember-cli from 3.15.1 to 3.15.2
81400b4 build(deps-dev): Bump lint-staged from 10.0.1 to 10.0.2
74b6b2f build(deps-dev): Bump ember-source from 3.15.0 to 3.16.0
2a18b80 build(deps-dev): Bump lint-staged from 10.0.0 to 10.0.1
22764f6 build(deps-dev): Bump lint-staged from 9.5.0 to 10.0.0
3c070d3 build(deps-dev): Bump ember-cli-htmlbars from 4.2.0 to 4.2.2
0577d7d Update template.md (#1102)
72f27a3 build(deps-dev): Bump eslint from 6.7.2 to 6.8.0
09c0eb7 build(deps-dev): Bump ember-cli from 3.14.0 to 3.15.1
79b9fbb build(deps-dev): Bump eslint-config-prettier from 6.7.0 to 6.9.0
e9c2b07 build(deps-dev): Bump mocha from 6.2.2 to 7.0.0
9c7ce39 build(deps-dev): Bump @ember/optional-features from 1.2.0 to 1.3.0
946e41c build(deps-dev): Bump eslint-plugin-node from 10.0.0 to 11.0.0
3e4016e build(deps-dev): Bump testdouble from 3.12.4 to 3.12.5
5a9b15c build(deps-dev): Bump ember-cli-addon-docs from 0.6.15 to 0.6.16
7f73cb8 ci: disabling ember lts 2.12 test run because of ember-data issues (#1101)
cbf1618 build(deps-dev): Bump ember-resolver from 6.0.1 to 7.0.0
16fffb9 build(deps-dev): Bump ember-resolver from 6.0.0 to 6.0.1
c69349b build(deps-dev): Bump @ember/optional-features from 1.1.0 to 1.2.0
5e5132c build(deps-dev): Bump eslint-plugin-prettier from 3.1.1 to 3.1.2
bdfdf8b build(deps-dev): Bump eslint-plugin-ember from 7.7.1 to 7.7.2
6a2a72d fix(blueprints): Installation of ember-intl in addon use correct app,config paths (#1078)
49593b5 build(deps): Bump ember-cli-babel from 7.13.0 to 7.13.2
601b1a6 build(deps-dev): Bump ember-try from 1.3.0 to 1.4.0
98deed0 build(deps-dev): Bump ember-cli-htmlbars from 4.1.1 to 4.2.0
8f69459 build(deps-dev): Bump ember-cli-htmlbars from 4.1.0 to 4.1.1
fc49c6b build(deps-dev): Bump ember-cli-htmlbars from 4.0.9 to 4.1.0
fabdd96 build(deps-dev): Bump ember-source from 3.14.3 to 3.15.0
8fa0050 chore: bump serialize-javascript to resolve security alert.
b82a475 build(deps-dev): Bump ember-cli-htmlbars from 4.0.8 to 4.0.9
2819920 build(deps-dev): Bump ember-source from 3.14.2 to 3.14.3
52d21bf build(deps-dev): Bump eslint from 6.7.1 to 6.7.2
37f3154 build(deps-dev): Bump eslint-plugin-ember from 7.7.0 to 7.7.1
333dbe0 build(deps-dev): Bump eslint-plugin-ember from 7.6.0 to 7.7.0
557ed24 docs: Update breaking change notes for 3.0 -> 4.0 to include removal of initializer
eb9e584 Update README.md
cf6df24 chore: adds lint-staged to prevent linting errors from being committed  (#1060)
8b2ce56 ci: linting
6c39c8c fix: App translations should beat Addon translations if there is a collision (#1059)
e2a2d5d Calculating caching key for tree with additionalCacheKeyParts (#1056)
9134fd5 build(deps-dev): Bump eslint from 6.7.0 to 6.7.1
ddafe16 build(deps-dev): Bump eslint from 6.6.0 to 6.7.0
ce6ef99 build(deps-dev): Bump ember-source from 3.14.1 to 3.14.2
6a8df55 chore: Removes compact number functionality in favor of incoming native notation API (#1053)
50ae49a build(deps-dev): Bump ember-resolver from 5.3.0 to 6.0.0
426b10c feat: Adds `notation` option to Intl.NumberFormat (#1048)
37895ea build(deps): Bump ember-cli-babel from 7.12.0 to 7.13.0 (#1051)
b894ed5 build(deps-dev): Bump eslint-plugin-ember from 7.5.0 to 7.6.0
c0426f4 build(deps-dev): Bump eslint-config-prettier from 6.6.0 to 6.7.0
192c581 build(deps-dev): Bump eslint-config-prettier from 6.5.0 to 6.6.0
1f99855 build(deps-dev): Bump ember-cli from 3.13.1 to 3.14.0
d64023c build(deps-dev): Bump ember-export-application-global
7ca985a chore: fixing ci, moving ember-data to ember-try config to deal with 2.12 issues. (#1042)
39fb2d3 build(deps-dev): Bump ember-try from 1.2.1 to 1.3.0 (#1039)
c607cda build(deps-dev): Bump eslint-plugin-ember from 7.4.0 to 7.5.0 (#1040)
5f024b4 build(deps-dev): Bump qunit-dom from 0.9.1 to 0.9.2
c410003 chore: bring back ember-data as devDep because of 2.12 issues that ember-cli-addon-docs implicitly brings over.
570f5c6 chore: bump caniuse to remove outdated warning, removes htmlbars inline precompiler.
f4efe5f chore: removes ember-data devDep.
e5ef0f0 chore: prettier changes due to minor prettier lib bump.
25f1c10 build(deps-dev): Bump prettier from 1.18.2 to 1.19.1 (#1038)
4123a6c build(deps-dev): Bump eslint-plugin-ember from 7.3.0 to 7.4.0
cf4b2e5 build(deps-dev): Bump ember-load-initializers from 2.1.0 to 2.1.1
74d64a3 chore: Adds Ember version badge
f0953d6 build(deps-dev): Bump eslint-plugin-ember from 7.2.0 to 7.3.0
8e164a4 build(deps-dev): Bump ember-source from 3.14.0 to 3.14.1 (#1027)
555940d build(deps-dev): Bump ember-source from 3.13.4 to 3.14.0
a53334e build(deps-dev): Bump ember-source from 3.13.3 to 3.13.4
4155634 build(deps-dev): Bump qunit-dom from 0.9.0 to 0.9.1
f378325 build(deps-dev): Bump eslint-config-prettier from 6.4.0 to 6.5.0
2ae27c7 build(deps-dev): Bump eslint from 6.5.1 to 6.6.0
5db7efe build(deps-dev): Bump @ember/optional-features from 1.0.0 to 1.1.0
0f902a1 chore: Fix formatting of documentation versions (#1019)
026d210 chore: Removes legacy migration doc section from README (#1018)
e03351b build(deps-dev): Bump eslint-plugin-ember from 7.1.0 to 7.2.0
2e9fc3a build(deps-dev): Bump ember-cli-htmlbars from 4.0.7 to 4.0.8
50ba839 build(deps-dev): Bump mocha from 6.2.1 to 6.2.2
fd8ee6e build(deps-dev): Bump ember-cli-htmlbars from 4.0.6 to 4.0.7
c22f5fe build(deps-dev): Bump ember-cli-htmlbars from 4.0.5 to 4.0.6
a4a18da build(deps): Bump cldr-core from 35.1.0 to 36.0.0 (#1011)
e68fd48 build(deps): Bump ember-auto-import from 1.5.2 to 1.5.3
d5b2f7e build(deps-dev): Bump ember-cli-inject-live-reload from 2.0.1 to 2.0.2 (#1010)
8febaac build(deps-dev): Bump ember-source from 3.13.2 to 3.13.3
9f098a6 build(deps-dev): Bump ember-cli-addon-docs from 0.6.14 to 0.6.15
cb975bf build(deps-dev): Bump eslint-config-prettier from 6.3.0 to 6.4.0
20a73d1 docs: add return value type to api docs (#1004)
34811c5 build(deps-dev): Bump ember-cli-htmlbars from 4.0.4 to 4.0.5
f30694b build(deps-dev): Bump ember-cli-htmlbars from 4.0.3 to 4.0.4
0e8243e build(deps-dev): Bump ember-cli-htmlbars-inline-precompile
4145755 build(deps-dev): Bump ember-cli-htmlbars from 4.0.2 to 4.0.3
af7b812 build(deps-dev): Bump eslint from 6.5.0 to 6.5.1
e8b4841 build(deps): Bump ember-cli-babel from 7.11.1 to 7.12.0 (#995)
da41738 build(deps-dev): Bump ember-cli-htmlbars from 4.0.1 to 4.0.2
518c87e build(deps-dev): Bump mocha from 6.2.0 to 6.2.1
1c04fed build(deps-dev): Bump eslint from 6.4.0 to 6.5.0
fb56975 build(deps-dev): Bump ember-cli from 3.13.0 to 3.13.1
cd84312 chore: spelling in README
c58676a build(deps-dev): Bump ember-source from 3.13.1 to 3.13.2
56f9a0f build(deps-dev): Bump ember-cli-htmlbars from 4.0.0 to 4.0.1
163e3a8 build(deps-dev): Bump ember-cli from 3.12.0 to 3.13.0
42c4372 chore: fix indenting in quickstart/template.md
d14f410 build(deps-dev): Bump ember-data from 3.12.3 to 3.12.4

git log --abbrev-commit --oneline v4.4.0..v5.0.6 |grep -i break:

"breaking"

9daa0ce (fix): Breaking test cases for nested translations (#1252)
a9426c9 chore: (BREAKING) removes supporting dasherized filter options.
5ea5298 feat(BREAKING): removes config.locales option. (#1190)
4b5e057 feat(BREAKING): upgrades parser, compiler, migrates to native intl.relativetime (#1186)
557ed24 docs: Update breaking change notes for 3.0 -> 4.0 to include removal of initializer

Is it really just a9426c9 (dasherized filter options), 5ea5298 (config.locales), and 4b5e057 (native intl.relativetime)? No change to supported Ember / Node versions, etc.?

See also https://github.com/ember-intl/ember-intl/issues/45

---

• I am on the latest ember-intl version
• I have searched the issues of this repo and believe that this is not a duplicate

Environment

N/A

Steps to Reproduce

N/A

[jasonmit]

Feedback received: https://github.com/ember-intl/ember-intl/releases/tag/v5.0.0

Noted some more changes here that I’ll need to reflect back in the docs as well.

5.0.0 was a release to simplify things, speed up builds & app boot (for those polyfilling especially), and reduce the bundle size (no polyfills & no pluralization rules).

[jasonmit]

@jacobq I linked it from the README - hopefully making it more visible.

I’ll try and add more details around what changes but the gist is there’s no more polyfills and all the pluralization rules are now no longer bundled with your app, the message parser/compiler was updated - which in turn fixes bugs around escaping and unlocks our ability to support all native APIs.

The big breaking change is around Intl.RelativeTimeFormat - the native API has evolved quite a bit as the spec evolved.

5.x will result in a smaller payload for those only targeting modern browsers.