Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Ember 5 release post #1273

Merged
merged 41 commits into from
Jun 23, 2023
Merged
Show file tree
Hide file tree
Changes from 3 commits
Commits
Show all changes
41 commits
Select commit Hold shift + click to select a range
c9c56bc
Template for Ember 5 Release Post
jenweber Apr 21, 2023
482df6c
Fill in some 5.x content
jenweber Apr 21, 2023
c16c8f5
Create the 5.x tag
jenweber Apr 21, 2023
2bb9906
Typo fixes
jenweber Apr 22, 2023
bba1fc9
Fix 4 -> 5
jenweber Apr 22, 2023
f174a18
Add content by Chris Krycho
jenweber May 9, 2023
5f4490a
Update content/ember-5-0-released.md
jenweber May 19, 2023
0d46551
Add Chris Krycho as an author
jenweber May 19, 2023
3be0890
Update content/ember-5-0-released.md
jenweber May 19, 2023
fc73df7
TS changes from Chris Krycho
jenweber May 19, 2023
4d1de3f
Update content/ember-5-0-released.md
chriskrycho May 19, 2023
f0712fb
Update content/ember-5-0-released.md
jaredgalanis May 20, 2023
5a41342
Update content/ember-5-0-released.md
jaredgalanis May 20, 2023
74817fa
Update content/ember-5-0-released.md
jaredgalanis May 20, 2023
eff2715
Update content/ember-5-0-released.md
jaredgalanis May 20, 2023
2116d74
Update content/ember-5-0-released.md
jaredgalanis May 20, 2023
27922c9
Apply suggestions from Katie
jenweber May 25, 2023
548ebc3
Mention @ember string deprecation
jenweber May 25, 2023
f20826e
Add more authors (Katie and Jared)
jenweber May 25, 2023
db069a2
Make the linter happy
jenweber May 26, 2023
3c61dcd
Copy in some EmberData blog material
jenweber May 26, 2023
574f0df
Document part of EmberData deprecation removals
jenweber May 26, 2023
a4aaea7
Linting fixes
jenweber May 26, 2023
1842f98
Update EmberData dep section wording
jenweber May 26, 2023
6e74f5d
Clarify cache method
jenweber May 26, 2023
0b141c4
linting, again
jenweber May 26, 2023
ab2911a
Update content/ember-5-0-released.md
jaredgalanis Jun 5, 2023
a4d6cdf
Update content/ember-5-0-released.md
jaredgalanis Jun 5, 2023
1c7b654
add bug fixes and clean up data a bit
jaredgalanis Jun 17, 2023
59ee323
add more data deprecations
jaredgalanis Jun 17, 2023
96461ba
Update content/ember-5-0-released.md
chriskrycho Jun 21, 2023
e7d5bda
Update content/ember-5-0-released.md
chriskrycho Jun 21, 2023
d716953
Update content/ember-5-0-released.md
chriskrycho Jun 21, 2023
3bb4c21
simplify data deprecations
jaredgalanis Jun 21, 2023
9848001
add CurrentDeprecations and how-to deprecations
jaredgalanis Jun 21, 2023
e3d76f3
Snappy blurb
MinThaMie Jun 22, 2023
ccdbf40
Update ember-5-0-released.md
MinThaMie Jun 22, 2023
e4f994b
Merge pull request #1283 from ember-learn/Snapp-blurb
jenweber Jun 22, 2023
c3a8679
Update ember-5-0-released.md
jenweber Jun 22, 2023
bb089a8
Update ember-5-0-released.md
jenweber Jun 22, 2023
d5b0c9f
Add the banner photo
jenweber Jun 23, 2023
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
184 changes: 184 additions & 0 deletions content/ember-5-0-released.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,184 @@
---
title: Ember 5 0 Released
jaredgalanis marked this conversation as resolved.
Show resolved Hide resolved
image:
imageMeta:
attribution:
attributionLink:
featured: true
authors:
- jen-weber
jenweber marked this conversation as resolved.
Show resolved Hide resolved
date: Mon May 15 2023 14:29:48 GMT-0400 (Eastern Daylight Time)
tags:
- releases
- '2023'
- version-5-x
---

Today the Ember project is releasing version 5.0 of Ember.js, Ember Data, and Ember CLI. This post will cover our release strategy, how to upgrade, what to expect, and deprecated APIs that were removed.

<!-- TODO - need a nice catchy intro that newsletters can copy paste -->

This is the first major release under the new 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 release, 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 change 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.
chriskrycho marked this conversation as resolved.
Show resolved Hide resolved

jenweber marked this conversation as resolved.
Show resolved Hide resolved
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 5.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 5

The most common approach for upgrading to 5.0 is to upgrade your app to the last
version of Ember 4, which is 4.12, resolve all deprecation warnings, and then upgrade to 5.0. If your app or addon runs with no deprecations in the latest release of 4.12,
you should be able to upgrade to Ember 4 with no additional changes. Step by step directions are below.

If your app is at a much earlier version in the 4.x series, we
recommend upgrading in steps across the LTS versions: 4.4, 4.8, and then 4.12.

Follow these steps in order:

1. Upgrade your project to the latest patch version of Ember 4.12.
jaredgalanis marked this conversation as resolved.
Show resolved Hide resolved
Many developers can do this by running
`npx ember-cli-update --to 4.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.
2. Make sure your app builds successfully.
3. Resolve all deprecation warnings. These Deprecated APIs are removed in Ember 5.0. You may need to upgrade some of your addon dependencies if they are using deprecated APIs.
jaredgalanis marked this conversation as resolved.
Show resolved Hide resolved
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).
4. Make sure your app builds successfully and your test suite passes with no
deprecations.
5. Upgrade your app to Ember 5.0. Again,
many developers can do this by running
`npx ember-cli-update --to 5.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/).

<!-- TODO - do we need to mention anything here about htmlbars, fastboot, embroider, or ember-auto-import? -->
jenweber marked this conversation as resolved.
Show resolved Hide resolved

## 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 5.0

Ember.js 5.0 is an incremental, backwards compatible release of Ember with bug fixes, performance improvements, and minor deprecations.
jenweber marked this conversation as resolved.
Show resolved Hide resolved

This release drops support for Node 14. Node 14 became end of life (it no longer receives security updates) as of April 2023.

#### Bug Fixes

Ember.js 5.0 introduced 0 bug fixes.
jenweber marked this conversation as resolved.
Show resolved Hide resolved

#### Features

Ember.js 5.0 introduced 2 features.
jenweber marked this conversation as resolved.
Show resolved Hide resolved

1. Feature description
jaredgalanis marked this conversation as resolved.
Show resolved Hide resolved
2. Feature description
jaredgalanis marked this conversation as resolved.
Show resolved Hide resolved

#### Deprecations

Ember.js 5.0 introduced 0 deprecations. It removed all deprecations that were
introduced before 4.10 and slated for removal in 5.0.

jenweber marked this conversation as resolved.
Show resolved Hide resolved
<!-- Block start: If there were no deprecations, remove this block -->

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/mixonic/ember-cli-deprecation-workflow) addon if you would like to upgrade your application without immediately addressing deprecations.

<!-- Block end -->

For more details on changes in Ember.js 5.0, please review the [Ember.js 5.0.0 release page](https://github.com/emberjs/ember.js/releases/tag/v5.0.0).

---

## Ember Data

Ember Data is the official data persistence library for Ember.js applications.

To learn about the motivation and goals for changes to Ember Data between 4.x and 5.x, check out the [blog post, EmberData 5.X Update](https://blog.emberjs.com/ember-data-5-x-update-2023-04-15/).

### Changes in Ember Data 5.0

#### Bug Fixes

Ember Data 5.0 introduced 0 bug fixes.

#### Features

Ember Data 5.0 introduced 0 features.

#### Deprecations

Ember Data 5.0 introduced 0 deprecations.

For more details on changes in Ember Data 5.0, please review the
[Ember Data 5.0.0 release page](https://github.com/emberjs/data/releases/tag/v5.0.0).

---

## 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 Ember Data, this is not required. After updating ember-cli, you can keep your current version(s) of Ember or Ember Data by editing `package.json` to revert the changes to the lines containing `ember-source` and `ember-data`.

### Changes in Ember CLI 5.0

#### Bug Fixes

Ember CLI 5.0 introduced 0 bug fixes.
jaredgalanis marked this conversation as resolved.
Show resolved Hide resolved

#### Features

Ember CLI 5.0 introduced 0 features.

#### Deprecations

Ember CLI 5.0 introduced 0 deprecations.

jaredgalanis marked this conversation as resolved.
Show resolved Hide resolved
For more details on the changes in Ember CLI 5.0 and detailed upgrade
instructions, please review the [Ember CLI 5.0.0 release page](https://github.com/ember-cli/ember-cli/releases/tag/v5.0.0).

jenweber marked this conversation as resolved.
Show resolved Hide resolved
## 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.

7 changes: 7 additions & 0 deletions tag/version-5-x.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: Version 5 X
image:
imageMeta:
---
A description for the Version 5 X tag. If you delete this line it will say
`A collection of X posts` where the description should go.