Ember 3.28 release

content/ember-3-28-released.md

@@ -0,0 +1,167 @@
+---
+title: Ember 3.28 and 4.0 Beta Released
+authors:
+  - matthew-beale
+  - jen-weber
+  - isaac-lee
+date: 2021-09-07T00:00:00.000Z
+tags:
+  - releases
+  - '2021'
+  - version-3-x
+---
+
+After 3.5 years and 28 minor releases, Ember 3.28 marks the end of the project's 3.x series.
+To ensure a smooth upgrade path going into the 4.x series, 3.28 has been declared an LTS (Long Term Support) candidate. In six weeks,
+the latest patch version of 3.28 will be promoted to be the latest LTS release
+and replace 3.24-LTS.
+
+**We're also announcing the start of the Ember 4.0 beta cycle for all sub-projects.** Following the process set in previous major versions, Ember 4.0's beta introduces no new features. Instead, it removes support for deprecated public APIs. We encourage our community (especially addon authors) to help test beta builds and report any bugs before they are published as a stable release in six weeks' time. We also encourage everyone to help maintainers resolve deprecations in their favorite addons. 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.
+
+Developers who want to prepare for the upcoming 4.0 version of Ember should work to resolve all deprecation warnings in their apps and addons while using Ember 3.28.
+An app or addon with no deprecation warnings on Ember 3.28 should be able to upgrade from Ember 4.0 without making significant changes outside of the
+dependency versions.
+
+You can read more about Ember's plans for 4.0 in [The Road to Ember 4.0](https://blog.emberjs.com/the-road-to-ember-4-0/).
+
+---
+
+## Ember.js
+
+Ember.js is the core framework for building ambitious web applications.
+
+### Changes in Ember.js 3.28
+
+Ember.js 3.28 is an incremental, backwards compatible release of Ember with bug fixes, performance improvements, and a minor deprecation fix. 3.28 introduces no new features, helping to ensure the final release of the 3.x cycle is stable and battle-tested.
+
+For the full set of changes (including 7 bug fixes), see the [Ember.js 3.28.0 release page](https://github.com/emberjs/ember.js/releases/tag/v3.28.0) on GitHub.
+
+In Ember 3.24, various string methods added to the `String.prototype` were deprecated for removal in Ember 4.0. `htmlSafe` (the version available via string prototype) was supposed to be included in those deprecations, however it was overlooked. This omission is corrected in 3.28.
+
+---
+
+## Ember Data
+
+Ember Data is the official data persistence library for Ember.js applications. The changes introduced in Ember Data 3.28 focus on bug fixes and refactors in preparation for 4.0.
+
+### Changes in Ember Data 3.28
+
+#### Improvements to relationship materialization & unloading performance
+
+A number of performance improvements were shipped in Ember Data 3.28, including
+significant improvements to relationship materialization and unloading performance
+via [emberjs/data#7491](https://github.com/emberjs/data/pull/7491) and
+[emberjs/data#7493](https://github.com/emberjs/data/pull/7493). In particular,
+the performance improvements should be notable when loading large sets of data.
+
+See the PRs linked above and [changelog](https://github.com/emberjs/data/blob/v3.28.3/CHANGELOG.md#release-3280-aug-20-2021) for further notes on performance improvements.
+
+#### Unload records from the store when calling `destroyRecord`
+
+`destroyRecord` would previously leave the deleted record in the store. This
+could cause issues if IDs were re-used, or could require extra filtering to
+confirm that destroyed content was not in an array of models.
+
+3.28 will unload records from the store when `destroyRecord` is called. For more
+details, see [emberjs/data#7258](https://github.com/emberjs/data/pull/7258) and
+the GitHub issues mentioned in the PR.
+
+#### Custom Model Classes
+
+Used conventionally, Ember Data blends the definition of a model's schema and
+record API into a single JavaScript class. For example:
+
+```js
+import Model from '@ember-data/model';
+
+export default class PersonModel extends Model {
+  /*
+   * Define a schema
+   */
+  @attr('string') firstName;
+  @attr('string') lastName;
+
+  /*
+   * Define an API on the record instance
+   */
+  get fullName() {
+    return `${this.firstName} ${this.lastName}`;
+  }
+}
+```
+
+Ember Data 3.28 introduces the ability to separate model schema and record instance
+class definitions. This is a low-level capability that we expect addon authors
+to use when they experiment in these areas (possibly others):
+
+First, forcing the definition (statically or at runtime) of a distinct class for
+every model can cause performance issues. Large applications may have hundreds
+of models. If most or all of these models do not require unique classes, we're
+generating more memory load and asking more of the JIT's type system than
+they may be necessary. In the extreme case, it may be possible for all record
+instances in an application to share a single root class.
+
+Second, the current Ember Data schema definition API forces definitions to be authored in
+JavaScript. Removing that limitation allows us to experiment with more optimal
+or powerful ways to encode schema (such as JSON). These alternatives may perform
+better (in payload size, or in parse/eval), may better support generation and
+synchronization with API typing systems, and better support static analysis
+(for example, with TypeScript).
+
+For further details on these new capabilities, refer to:
+
+- [RFC #487: Custom Model Class](https://github.com/emberjs/rfcs/blob/master/text/0487-custom-model-classes.md)
+- [RFC #466: Request State Service](https://github.com/emberjs/rfcs/blob/master/text/0466-request-state-service.md)
+- [RFC #463: Record State on RecordData](https://github.com/emberjs/rfcs/blob/master/text/0463-record-data-state.md)
+- [RFC #463: RecordData Errors](https://github.com/emberjs/rfcs/blob/master/text/0465-record-data-errors.md)
+
+Much of this API surface is already used by the
+[ember-m3](https://github.com/hjdivad/ember-m3) project, which provides an
+alternative model class for Ember Data.
+
+#### Bug Fixes
+
+Ember Data 3.28 introduced 12 bug fixes and some internal refactors. For the full set of changes, see the [CHANGELOG.md](https://github.com/emberjs/data/blob/v3.28.3/CHANGELOG.md#release-3280-aug-20-2021).
+
+---
+
+## Ember CLI
+
+Ember CLI is the command line interface for managing and packaging Ember.js applications.
+
+### Changes in Ember CLI 3.28
+
+#### Drop Node 10 support
+
+Ember CLI 3.28 drops support for Node 10. Node 10 became end of life (it no longer receives security updates) in April 2021.
+
+#### Introducing `ember-addon.projectRoot`
+
+This new configuration option allows you to run `ember serve` from outside of a project's root directory. For example, if you're using yarn workspace or a monorepo and want to support running `ember serve` from the root of the repo, update the top-level `package.json` to include the following config:
+
+```json
+{
+  "ember-addon": {
+    "projectRoot": "./packages/path-to-ember-project"
+  }
+}
+```
+
+For more details on the changes in Ember CLI 3.28 and detailed upgrade
+instructions, please review the [Ember CLI 3.28.0 release page](https://github.com/ember-cli/ember-cli/releases/tag/v3.28.0).
+
+### 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`.
+
+## 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.