From 4864978effa508f587c3764f6bcba3eeedc4670e Mon Sep 17 00:00:00 2001 From: Jared Galanis Date: Wed, 20 Nov 2024 15:10:52 -0500 Subject: [PATCH 01/12] create release blog post shell --- content/ember-6-0-released.md | 226 ++++++++++++++++++++++++++++++++++ 1 file changed, 226 insertions(+) create mode 100644 content/ember-6-0-released.md diff --git a/content/ember-6-0-released.md b/content/ember-6-0-released.md new file mode 100644 index 000000000..d67b784bd --- /dev/null +++ b/content/ember-6-0-released.md @@ -0,0 +1,226 @@ +--- +title: Ember 6.0 Released +image: +imageMeta: + attribution: + attributionLink: +featured: true +authors: + - jared-galanis +date: 2024-11-20T00:00:00.000Z +tags: + - releases + - '2023' + - version-5-x +--- + +EmberJS 6.0 embodies the commitment to stability and reliability that developers have come to expect from the Ember ecosystem. The Ember team has worked hard to remove all the deprecations and make us move towards Polaris. Get up-to-date with the latest in Ember and enjoy! + +This post will cover our release strategy, how to upgrade, what to expect, and deprecated APIs that were removed. + +This release follwos the release strategy and goals proposed in [RFC 830, Evolving Ember's Major Version Process](https://rfcs.emberjs.com/id/0830-evolving-embers-major-version-process). +To summarize, every 12 minor releases, Ember will ship a new major release, which removes any +deprecated code targeted for that major version. + +When it comes to introducing new features, Ember generally aims to ship new features in minor releases, offering backwards compatibility for existing code at the same time as giving developers the chance to try out new capabilities. +This approach reduces the challenges that teams face for major upgrades, compared to producing big, breaking, splashy major versions with lots of new features. + + + +In Ember 5.x minor releases, we landed a bunch of features (along with various bug fixes, of course): + +- In [Ember 5.1]() +- In [Ember 5.2]() +- In [Ember 5.3]() +- In [Ember 5.4]() +- In [Ember 5.5]() +- In [Ember 5.6]() +- In [Ember 5.7]() +- In [Ember 5.8]() +- In [Ember 5.9]() +- In [Ember 5.10]() +- In [Ember 5.11]() +- In [Ember 5.12]() + +We also made significant strides in key parts of the ecosystem outside the core framework itself over the past 18 months: + +[list strides here] + +Ember 6.0 has no new features, because we did all that work in minor releases instead. + +You can read more about our general release process here: + +- [Release Dashboard](http://emberjs.com/releases/) +- [The Ember Release Cycle](https://blog.emberjs.com/new-ember-release-process/) +- [The Ember Project](https://blog.emberjs.com/ember-project-at-2-0/) +- [Ember LTS Releases](https://blog.emberjs.com/announcing-embers-first-lts/) + +## Beta cycle + +This release kicks off the 6.1 beta cycle for all sub-projects. We encourage our community (especially addon authors) to help test these beta builds and report any bugs before they are published as a final release in six weeks' time. The [ember-try](https://github.com/ember-cli/ember-try) addon is a great way to continuously test your projects against the latest Ember releases. + +## How to upgrade to Ember 6 + +The most common approach for upgrading to 6.0 is to upgrade your app to the last +version of Ember 5, which is 5.12, resolve all deprecation warnings, and then upgrade to 6.0. If your app or addon runs with no deprecations in the latest release of 5.12, +you should be able to upgrade to Ember 6 with no additional changes. Step by step directions are below. + +If your app is at a much earlier version in the 5.x series, we +recommend upgrading in steps across the LTS versions: 5.4, 5.8, and then 5.12. + +Follow these steps in order: + +1. Consider [upgrading addons used in your app](https://cli.emberjs.com/release/basic-use/upgrading/#upgradingaddondependencies) + to the latest version that you can. This will reduce the uses of deprecated APIs in your dependencies. +2. Upgrade your project to the latest patch version of Ember 5.12. + Many developers can do this by running + `npx ember-cli-update --to 5.12`. The + [general Ember upgrade guide](https://cli.emberjs.com/release/basic-use/upgrading/#upgradinganemberappitself) + has more details about how to upgrade your Ember app/addon. +3. Make sure your app builds successfully. +4. Resolve all deprecation warnings. These Deprecated APIs are removed in Ember 6.0. You may need to upgrade some of your addon dependencies if they are using deprecated APIs. + See the [Ember Deprecation Guide](https://deprecations.emberjs.com/) + for more details about specific deprecations and how to resolve them. + Applications that need to upgrade through several versions may want to + consider isolating individual deprecations by using + [ember-cli-deprecation-workflow](https://github.com/mixonic/ember-cli-deprecation-workflow). +5. Make sure your app builds successfully and your test suite passes with no + deprecations. +6. Upgrade your app to Ember 6.0. Again, + many developers can do this by running + `npx ember-cli-update --to 6.0`. Refer to the + [general Ember upgrade guide](https://cli.emberjs.com/release/basic-use/upgrading/#upgradinganemberappitself) + for more details about how to upgrade your Ember app/addon. + +For help or advice along the way, visit [Ember's forums or chat groups](https://emberjs.com/community/). + +## The journey towards Ember Polaris + +Polaris is the name of an upcoming edition of Ember, first announced at EmberConf 2021. Over the course of 5.x, new features will be added to Ember that will eventually make up the new edition. + +Since our major versions tend to be uneventful, Editions are the moment where the Ember community comes together to learn and build in new ways. +An edition is a set of features, corresponding documentation, and tools that create a cohesive programming model. +An edition marks a shift and step forward in the framework, beyond what individual features would accomplish. +Ember Octane was the first new edition that was added to Ember. + +Stay tuned for future blog posts with more details and calls for contributors! + +--- + +## Ember.js + +Ember.js is the core framework for building ambitious web applications. + +### Changes in Ember.js 6.0 + +Ember.js 6.0 introduces no new public API. Instead, it is comprised of bug fixes and the removal of previously deprecated public API from the 5.x cycle. + +#### Bug Fixes + +[list bug fixes] + +#### Features + +Ember.js 6.0 introduced no new features. + +#### Deprecations + +Ember.js 6.0 introduced 0 deprecations. It removed all deprecations that were +introduced before 5.10 and slated for removal in 6.0. + +Ember 6.0 removes the following features deprecated during 5.x: + +[list deprecation removals] + +For more details on how to resolve these deprecations in your app, see [the deprecations guide](https://deprecations.emberjs.com/v5.x). + + + +Deprecations are added to Ember.js when an API will be removed at a later date. Each deprecation has an entry in the deprecation guide describing the migration path to a more stable API. Deprecated public APIs are not removed until a major release of the framework. + +Consider using the [ember-cli-deprecation-workflow](https://github.com/ember-cli/ember-cli-deprecation-workflow) addon if you would like to upgrade your application without immediately addressing deprecations. + + + +For more details on changes in Ember.js 6.0, please review the [Ember.js 6.0.0 release page](https://github.com/emberjs/ember.js/releases/tag/v6.0.0). + +--- + +## EmberData + +EmberData is the official data persistence library for Ember.js applications. + +EmberData 5.12 will remain an actively supported LTS for the entire duration of the 5.x cycle, extending until the first 6.x LTS is released. This is in addition to our regular LTS support policy, and only applies to the EmberData project. + +This support extends beyond bug-fixes. If minor enhancements can be made to better support new presentation class implementations that support the 5.x series we will willingly accept them. Our goal is that we want no one left behind. + +To learn about the motivation and goals for upcoming changes to EmberData in 5.x, +read the [blog post, EmberData 5.X Update](https://blog.emberjs.com/ember-data-5-x-update-2023-04-15/). + + + +This will help you form the mental model of what to expect across the 5.x series, +and understand deprecation removals in the context of the upcoming goals. + +The sections below will provide a high-level summary of what has changed between +EmberData 5.12 and 6.0. + +### Changes in EmberData + +#### Bug Fixes + +EmberData is the official data persistence library for Ember.js applications. + +This release cycle EmberData is again electing to not release a new minor. + +Work in the library continues to be focused primarily on aligning 4.12 and 5.3 to enable as many folks in the community to seamlessly upgrade as possible. + + + +We continue to take our time with 5.4 as we intend to introduce a major new paradigm with it (the replacement for @ember-data/model) and believe releasing this new feature at once on the heels of two very robust LTSs (4.12 and 5.3) is the best approach for users looking to navigate upgrades easily. + +Please see the [blog post](https://blog.emberjs.com/updates-to-ember-data-versioning-strategy) addressing EmberData's new versioning strategy for more information. + +--- + +## Ember CLI + +Ember CLI is the command line interface for managing and packaging Ember.js applications. + +### Upgrading Ember CLI + +You may upgrade Ember CLI using the `ember-cli-update` project: + +```bash +npx ember-cli-update +``` + +This utility will help you to update your app or addon to the latest Ember CLI version. You will probably encounter merge conflicts, in which the default behavior is to let you resolve conflicts on your own. For more information on the `ember-cli-update` project, see [the GitHub README](https://github.com/ember-cli/ember-cli-update). + +While it is recommended to keep Ember CLI versions in sync with Ember and EmberData, this is not required. After updating ember-cli, you can keep your current version(s) of Ember or EmberData by editing `package.json` to revert the changes to the lines containing `ember-source` and `ember-data`. + +### Changes in Ember CLI 6.0 + +#### Bug Fixes + +[list bug fixes] + +#### Features + +Ember CLI 6.0 introduced 0 features. + +#### Deprecations + +Ember CLI 6.0 introduced 0 deprecations. +Ember CLI 6.0 removed features and APIs that were deprecated in 5.x or earlier, please see the [Deprecation guide](https://deprecations.emberjs.com/ember-cli/v5.x) for more information: + +[list deprecation removals] + + + +For more details on the changes in Ember CLI 6.0 and detailed upgrade +instructions, please review the [Ember CLI 6.0.0 release page](https://github.com/ember-cli/ember-cli/releases/tag/v6.0.0). + +## Thank You! + +As a community-driven open-source project with an ambitious scope, each of these releases serves as a reminder that the Ember project would not have been possible without your continued support. We are extremely grateful to our contributors for their efforts. From be8934386b01eff9347a0041af5d00287b0158e1 Mon Sep 17 00:00:00 2001 From: Jared Galanis Date: Wed, 20 Nov 2024 15:31:15 -0500 Subject: [PATCH 02/12] add ember.js bug fixes and deps removals --- content/ember-6-0-released.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/content/ember-6-0-released.md b/content/ember-6-0-released.md index d67b784bd..3a3b7abf8 100644 --- a/content/ember-6-0-released.md +++ b/content/ember-6-0-released.md @@ -96,7 +96,7 @@ For help or advice along the way, visit [Ember's forums or chat groups](https:// ## The journey towards Ember Polaris -Polaris is the name of an upcoming edition of Ember, first announced at EmberConf 2021. Over the course of 5.x, new features will be added to Ember that will eventually make up the new edition. +Polaris is the name of an upcoming edition of Ember, first announced at EmberConf 2021. Over the course of 6.x, new features will be added to Ember that will eventually make up the new edition. Since our major versions tend to be uneventful, Editions are the moment where the Ember community comes together to learn and build in new ways. An edition is a set of features, corresponding documentation, and tools that create a cohesive programming model. @@ -117,7 +117,7 @@ Ember.js 6.0 introduces no new public API. Instead, it is comprised of bug fixes #### Bug Fixes -[list bug fixes] +- [#20731](https://github.com/emberjs/ember.js/pull/20731) - Bump barrel file deprecations until 7.0.0 #### Features @@ -130,6 +130,11 @@ introduced before 5.10 and slated for removal in 6.0. Ember 6.0 removes the following features deprecated during 5.x: +- [Removing](https://deprecations.emberjs.com/id/deprecate-implicit-route-model) the implicit route model hook behavior where if no `Route#model` hook was specified and a `_id` parameter was present, Ember would attempt to figure out how to load that model for you. +- [Removing](https://deprecations.emberjs.com/id/template-action) the `(action)` template helper and `{{action}}` modifier now that we have native classes and the `{{on}}` modifier. +- [Removing](https://deprecations.emberjs.com/id/component-template-resolving) the runtime resolution of component templates, so if there is an import involved, there is no runtime resolution. +- [Removing](https://deprecations.emberjs.com/id/deprecate-array-prototype-extensions) the extension of the prototypes of native Javascript arrays to implement `Ember.Enumerable`, `Ember.MutableEnumerable`, `Ember.MutableArray`, `Ember.Array`. For convenient functions like `filterBy` or `compact`, you can directly convert to use native array methods. + [list deprecation removals] For more details on how to resolve these deprecations in your app, see [the deprecations guide](https://deprecations.emberjs.com/v5.x). From 5b093d29ae2eb4dedaa5ff43fe66bffde5da7c2e Mon Sep 17 00:00:00 2001 From: Jared Galanis Date: Wed, 20 Nov 2024 15:54:45 -0500 Subject: [PATCH 03/12] add v6 tag --- content/ember-6-0-released.md | 2 +- tag/version-6-x.md | 8 ++++++++ 2 files changed, 9 insertions(+), 1 deletion(-) create mode 100644 tag/version-6-x.md diff --git a/content/ember-6-0-released.md b/content/ember-6-0-released.md index 3a3b7abf8..bb3c7fd0a 100644 --- a/content/ember-6-0-released.md +++ b/content/ember-6-0-released.md @@ -11,7 +11,7 @@ date: 2024-11-20T00:00:00.000Z tags: - releases - '2023' - - version-5-x + - version-6-x --- EmberJS 6.0 embodies the commitment to stability and reliability that developers have come to expect from the Ember ecosystem. The Ember team has worked hard to remove all the deprecations and make us move towards Polaris. Get up-to-date with the latest in Ember and enjoy! diff --git a/tag/version-6-x.md b/tag/version-6-x.md new file mode 100644 index 000000000..5676c2e7e --- /dev/null +++ b/tag/version-6-x.md @@ -0,0 +1,8 @@ +--- +name: Version 6 X +image: +imageMeta: +--- + +A description for the Version 6 X tag. If you delete this line it will say +`A collection of X posts` where the description should go. From 7e94f40a1c19e448c452ca3674f1f78b55fd47b4 Mon Sep 17 00:00:00 2001 From: Jared Galanis Date: Wed, 20 Nov 2024 15:55:19 -0500 Subject: [PATCH 04/12] update year --- content/ember-6-0-released.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ember-6-0-released.md b/content/ember-6-0-released.md index bb3c7fd0a..1b2b40441 100644 --- a/content/ember-6-0-released.md +++ b/content/ember-6-0-released.md @@ -10,7 +10,7 @@ authors: date: 2024-11-20T00:00:00.000Z tags: - releases - - '2023' + - '2024' - version-6-x --- From c675ffbee0c172729a517183d535e8bc1ad1906a Mon Sep 17 00:00:00 2001 From: Katie Gengler Date: Tue, 17 Dec 2024 14:05:22 -0500 Subject: [PATCH 05/12] Update content/ember-6-0-released.md --- content/ember-6-0-released.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ember-6-0-released.md b/content/ember-6-0-released.md index 1b2b40441..153a409be 100644 --- a/content/ember-6-0-released.md +++ b/content/ember-6-0-released.md @@ -18,7 +18,7 @@ EmberJS 6.0 embodies the commitment to stability and reliability that developers This post will cover our release strategy, how to upgrade, what to expect, and deprecated APIs that were removed. -This release follwos the release strategy and goals proposed in [RFC 830, Evolving Ember's Major Version Process](https://rfcs.emberjs.com/id/0830-evolving-embers-major-version-process). +This release follows the release strategy and goals proposed in [RFC 830, Evolving Ember's Major Version Process](https://rfcs.emberjs.com/id/0830-evolving-embers-major-version-process). To summarize, every 12 minor releases, Ember will ship a new major release, which removes any deprecated code targeted for that major version. From 91935228c4f68b699bc894a12367e90f2f01ae51 Mon Sep 17 00:00:00 2001 From: Katie Gengler Date: Tue, 17 Dec 2024 14:17:30 -0500 Subject: [PATCH 06/12] Update content/ember-6-0-released.md Co-authored-by: NullVoxPopuli <199018+NullVoxPopuli@users.noreply.github.com> --- content/ember-6-0-released.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ember-6-0-released.md b/content/ember-6-0-released.md index 153a409be..a70a1a107 100644 --- a/content/ember-6-0-released.md +++ b/content/ember-6-0-released.md @@ -29,7 +29,7 @@ This approach reduces the challenges that teams face for major upgrades, compare In Ember 5.x minor releases, we landed a bunch of features (along with various bug fixes, of course): -- In [Ember 5.1]() +- In [Ember 5.1](https://blog.emberjs.com/ember-released-5-1/) - In [Ember 5.2]() - In [Ember 5.3]() - In [Ember 5.4]() From 1d8cef94f4dcf582f2a691a4840fce9f5ebcaf81 Mon Sep 17 00:00:00 2001 From: Katie Gengler Date: Tue, 17 Dec 2024 14:18:16 -0500 Subject: [PATCH 07/12] Add links to Ember version blog posts Co-authored-by: NullVoxPopuli <199018+NullVoxPopuli@users.noreply.github.com> --- content/ember-6-0-released.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/content/ember-6-0-released.md b/content/ember-6-0-released.md index a70a1a107..198e14f16 100644 --- a/content/ember-6-0-released.md +++ b/content/ember-6-0-released.md @@ -30,17 +30,17 @@ This approach reduces the challenges that teams face for major upgrades, compare In Ember 5.x minor releases, we landed a bunch of features (along with various bug fixes, of course): - In [Ember 5.1](https://blog.emberjs.com/ember-released-5-1/) -- In [Ember 5.2]() -- In [Ember 5.3]() -- In [Ember 5.4]() -- In [Ember 5.5]() -- In [Ember 5.6]() -- In [Ember 5.7]() -- In [Ember 5.8]() -- In [Ember 5.9]() -- In [Ember 5.10]() -- In [Ember 5.11]() -- In [Ember 5.12]() +- In [Ember 5.2](https://blog.emberjs.com/ember-released-5-2/) +- In [Ember 5.3](https://blog.emberjs.com/ember-released-5-3/) +- In [Ember 5.4](https://blog.emberjs.com/ember-released-5-4/) +- In [Ember 5.5](https://blog.emberjs.com/ember-released-5-5/) +- In [Ember 5.6](https://blog.emberjs.com/ember-released-5-6/) +- In [Ember 5.7](https://blog.emberjs.com/ember-released-5-7/) +- In [Ember 5.8](https://blog.emberjs.com/ember-released-5-8/) +- In [Ember 5.9](https://blog.emberjs.com/ember-released-5-9/) +- In [Ember 5.10](https://blog.emberjs.com/ember-released-5-10/) +- In [Ember 5.11](https://blog.emberjs.com/ember-released-5-11/) +- In [Ember 5.12](https://blog.emberjs.com/ember-released-5-12/) We also made significant strides in key parts of the ecosystem outside the core framework itself over the past 18 months: From 331b3db08ca5f55dda3b1839c5069fab231f9341 Mon Sep 17 00:00:00 2001 From: Edward Faulkner Date: Tue, 17 Dec 2024 15:43:40 -0500 Subject: [PATCH 08/12] Apply suggestions from code review Co-authored-by: Katie Gengler --- content/ember-6-0-released.md | 53 ++++++++++++++++++++--------------- 1 file changed, 30 insertions(+), 23 deletions(-) diff --git a/content/ember-6-0-released.md b/content/ember-6-0-released.md index 198e14f16..5cd5a5959 100644 --- a/content/ember-6-0-released.md +++ b/content/ember-6-0-released.md @@ -14,7 +14,7 @@ tags: - version-6-x --- -EmberJS 6.0 embodies the commitment to stability and reliability that developers have come to expect from the Ember ecosystem. The Ember team has worked hard to remove all the deprecations and make us move towards Polaris. Get up-to-date with the latest in Ember and enjoy! +Ember 6.0 continues the commitment to stability and reliability that developers have come to expect from the Ember ecosystem and further moves us towards the [Polaris Edition of Ember](https://emberjs.com/editions/polaris/). Get up-to-date with the latest in Ember and enjoy! This post will cover our release strategy, how to upgrade, what to expect, and deprecated APIs that were removed. @@ -29,24 +29,31 @@ This approach reduces the challenges that teams face for major upgrades, compare In Ember 5.x minor releases, we landed a bunch of features (along with various bug fixes, of course): -- In [Ember 5.1](https://blog.emberjs.com/ember-released-5-1/) -- In [Ember 5.2](https://blog.emberjs.com/ember-released-5-2/) -- In [Ember 5.3](https://blog.emberjs.com/ember-released-5-3/) -- In [Ember 5.4](https://blog.emberjs.com/ember-released-5-4/) -- In [Ember 5.5](https://blog.emberjs.com/ember-released-5-5/) -- In [Ember 5.6](https://blog.emberjs.com/ember-released-5-6/) -- In [Ember 5.7](https://blog.emberjs.com/ember-released-5-7/) -- In [Ember 5.8](https://blog.emberjs.com/ember-released-5-8/) -- In [Ember 5.9](https://blog.emberjs.com/ember-released-5-9/) -- In [Ember 5.10](https://blog.emberjs.com/ember-released-5-10/) -- In [Ember 5.11](https://blog.emberjs.com/ember-released-5-11/) -- In [Ember 5.12](https://blog.emberjs.com/ember-released-5-12/) +- In [Ember 5.1](https://blog.emberjs.com/ember-released-5-1/), we published [stable types from Ember's own TypeScript source code](https://blog.emberjs.com/stable-typescript-types-in-ember-5-1). We also shipped official support for `pnpm` in `ember-cli`. +- In [Ember 5.2](https://blog.emberjs.com/ember-released-5-2/), we added a public import for the `uniqueId` helper so it can be used in `