Ember 2.10 unified blog post #2727

locks · 2016-11-28T14:34:16Z

Rendered. Ship approvals (once nominated as complete and we remove the WIP):

Ember (@chancancode)
Data (@bmac)
CLI (@nathanhammond)
Website (@locks, @mixonic)

Draft

Ember

2.10 changes
2.11 beta upcoming changes

Ember Data

2.10 changes
2.11 beta changes

Ember CLI

Ember / Ember Data upgrade instructions
2.10 changes
2.11 changes

igorT · 2016-11-28T20:20:53Z

source/blog/2016-11-28-ember-2-10-released.md

+One of the performance improvements included in the Ember Data
+2.11.0-beta.1 release fixed an issue where Ember Data was doing too
+much work when records in a `DS.hasMany()` changed. As a result of
+this extra work Ember Data would incorrectly invalid computed


runspired · 2016-11-28T20:35:18Z

source/blog/2016-11-28-ember-2-10-released.md

+
+[@runspired](https://github.com/runspired) also
+[improved the messaging](https://github.com/emberjs/data/pull/4578)
+around assertions and warnings when an adapter responses with no `id`


runspired · 2016-11-28T20:36:59Z

source/blog/2016-11-28-ember-2-10-released.md

+`record.serialize()` in place of `store.serialize(record)` or
+`snapshot.serialize()` in place of
+`adapter.serialize(snapshot)`. `store#serialize()` and
+`adapter#serialize()` will be removed in Ember Data 3.0.0.


there's at least one other deprecation to public API in 2.11

https://github.com/emberjs/data/blob/master/addon/-private/system/store.js#L2595-L2609

^ newly deprecated methods lookupAdapter and lookupSerializer, these were never fully public or private and should get a mention.

store.recordIsLoaded deprecation emberjs/data#4665

nathanhammond · 2016-11-28T23:49:45Z

I've completed the CLI draft. You're encouraged to directly make edits and commit to this branch to improve it as you see fit. If I disagree we'll fix forward.

runspired · 2016-11-29T01:02:08Z

We should mention the other deprecations or link to the release notes with them for 2.11 beta, but otherwise the ED section is looking good to me.

chancancode · 2016-11-29T02:12:13Z

@bmac @nathanhammond @locks @mixonic @runspired @rwjblue @igorT please review fa1d1d5

dgeb · 2016-11-29T02:17:58Z

source/blog/2016-11-28-ember-2-10-released.md

+Today, the Ember project is releasing Ember.js, Ember Data and Ember CLI
+version 2.10.0.
+
+This also kicks off the 2.11 beta cycle for all sub-projects. We enourage our


dgeb · 2016-11-29T02:19:55Z

source/blog/2016-11-28-ember-2-10-released.md


 ### Changes in Ember Data 2.10

+Ember Data 2.10 represents the work of over 11 direct contributors and over
+27 commits.


The use of "over" in this sentence is a bit confusing combined with such specific numbers.

8426c1d ?

dgeb · 2016-11-29T02:22:13Z

source/blog/2016-11-28-ember-2-10-released.md

@@ -123,7 +158,7 @@ which should be non-breaking. If you experience issues you will
 Concatenation of assets has been implicit based upon file-system ordering. An
 update to `broccoli-concat` which changed the walk order of the file system to
 guarantee consistency and stable concatenation broke the implicit reliance we
-had on that ordering. To ensure that we were backwards compatible 
+had on that ordering. To ensure that we were backwards compatible


consider replacing "were backwards compatible" with "remain backwards compatible"

locks · 2016-11-29T02:17:20Z

source/blog/2016-11-28-ember-2-10-released.md

+
+This also kicks off the 2.11 beta cycle for all sub-projects. We enourage 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


no parens around last sentence

locks · 2016-11-29T02:19:50Z

source/blog/2016-11-28-ember-2-10-released.md

+- [The Ember Project](http://emberjs.com/blog/2015/06/16/ember-project-at-2-0.html)
+- [Ember LTS Releases](http://emberjs.com/blog/2016/02/25/announcing-embers-first-lts.html)
+
+---


small note about unified blog post? "We're trying out this format, let us know what you think"? maybe too informal.

I don't think all visitors need to be asked to let us know about the format. Seems a good thing to ask for feedback on in Slack after the fact.

I added a note about it in the release process section

locks · 2016-11-29T02:20:40Z

source/blog/2016-11-28-ember-2-10-released.md

+Ember CLI is the command line interface for managing and packaging Ember.js
+applications.
+
+### Upgrading Ember CLI


other sub-projects should have a matching section maybe?

locks · 2016-11-29T02:22:11Z

source/blog/2016-11-28-ember-2-10-released.md

+For more details on the changes in Ember.js 2.10, please review the
+[Ember.js 2.10.0 release page](https://github.com/emberjs/ember.js/releases/tag/v2.10.0).
+
+### Upcoming changes in Ember.js 2.11


I'm a bit worried this might frame as "they're definitely coming", but in the Data section there's already an exception to the rule. am I reading too much into it?

dgeb · 2016-11-29T02:23:49Z

source/blog/2016-11-28-ember-2-10-released.md

@@ -174,6 +212,14 @@ making rebuilds work for changes in that directory.
 - Stefan Penner [made it so we do a better job at cleanup up on exit of Ember CLI](https://github.com/ember-cli/ember-cli/pull/6423)


s/up on/upon/

dgeb · 2016-11-29T02:24:13Z

source/blog/2016-11-28-ember-2-10-released.md

-There are many other improvements, and as always we're grateful to our contributors for their efforts.
+As a community-driven open-source project with an ambitious scope, each of
+these releases serve as a reminder that the Ember project would not have been
+possible without your continued support. We are extremely greatful to our


s/greatful/grateful/

runspired · 2016-11-29T02:45:28Z

source/blog/2016-11-28-ember-2-10-released.md

+fix you may need to update computed property keys that depended on
+`record.hasManyRelationshipName` to `record.hasManyRelationshipName.[]`.
+
+#### Deprecate store.serialize


My comments from before seemed to get lost so I'll redo them quick. 2.11 also deprecates:

store.lookupAdapter and store.lookupSerializer as they are simply proxies for store.adapterFor and store.serializerFor. These methods were never fully public or private.
(changes: https://github.com/emberjs/data/blob/master/addon/-private/system/store.js#L2595-L2609)

store.recordIsLoaded is deprecated in favor of store.hasRecordForId, as these methods have been identical for sometime. Deprecate store.recordIsLoaded data#4665

xomaczar · 2016-11-29T04:03:55Z

source/blog/2016-11-28-ember-2-10-released.md

+
+`store#lookupAdapter()` and `store#lookupSerializer()` have also been
+deprecated starting in Ember 2.11. These methods were never publicly
+documented. In their place we recommended you use `store#adapterFor()`


:s/recommended/recommend

locks · 2016-11-29T06:20:30Z

Should we also include the Ember, Ember Data, Ember CLI tags to the metadata?

mixonic · 2016-11-29T07:06:24Z

The tags pick what sidebar menu the post appears in. And the blog isn't currently set up for bundled Ember Data and Ember releases. Current sidebars are:

Recent posts
Releases
Ember Data

Per the last cleanup PR. A blog post should only be in one of those categories, IMO. So I'd suggest this be in the Releases tag only.

I think a good followup PR would be to migrate existing "Ember Data" tagged blog posts to have the "Releases" tag, drop the ember-data sidebar, then expand the releases to take 14 instead of 7. But it seems good to split that work out.

chancancode · 2016-11-29T07:07:12Z

I just finished writing my part. Am I supposed to get someone else to approve it? I nominate @mixonic 😬

chancancode · 2016-11-29T07:15:28Z

source/blog/2016-11-28-ember-2-10-released.md

+20 commits.
+
+There have been no user facing changes in Ember Data 2.10. Under the
+hood, [@runspired](https://github.com/runspired) has instrumented


Should we normalize these mentions to use real names (see the Ember section above)? @runspired do you mind?

Historically we've used handles in blog posts, but I am aok with swapping to names. I kind of like it in fact.

There can be issues with names I suppose, but with handles there are times when twitter/github disagree and knowing which to pick is difficult.

chancancode · 2016-11-29T07:16:36Z

source/blog/2016-11-28-ember-2-10-released.md

+#### HasMany Computed Property Keys
+
+One of the performance improvements included in the Ember Data
+2.11.0-beta.1 release fixes an issue where Ember Data was doing too


I think this should be "2.11" per fa1d1d5

josemarluedke · 2016-11-29T07:16:37Z

source/blog/2016-11-28-ember-2-10-released.md

+Thanks to everyone in the community who took the time to test their apps and
+addons against the Glimmer 2 alpha and beta builds, this has been one of the
+most rigorously tested release in the history of the Ember project. We are
+quite confident that upgrade with go smoothly for most apps. However, if you


Should this be will go smoothly instead of with go?

chancancode · 2016-11-29T07:18:03Z

source/blog/2016-11-28-ember-2-10-released.md

+[March 2015](https://github.com/emberjs/data/pull/2875).
+
+All of the deprecated methods mentioned above will remain in Ember
+Data until v3.0.0. Until then they will log a deprecation warning to


"3.0"... I think..

chancancode · 2016-11-29T07:20:58Z

source/blog/2016-11-28-ember-2-10-released.md

+adapter operation should look like: specify the used HTTP method or
+provide custom HTTP headers per request. This feature has been enabled
+in the beta channel in 2.8-beta and has been enabled in the beta
+channel since.


Nit: I understand the subtlety this is trying to get across (after reading it a few times), but it is a bit clumsy. Does "This feature has been in beta since Ember Data 2.8" preserve enough of that technicality?

chancancode · 2016-11-29T07:21:33Z

source/blog/2016-11-28-ember-2-10-released.md

+
+#### Testing Addons
+
+Ember CLI v2.10 removes Ember.js v1.13 from the default testing matrix in the


"Ember CLI 2.10" and "Ember.js 1.13"

chancancode · 2016-11-29T07:21:40Z

source/blog/2016-11-28-ember-2-10-released.md

+
+Ember CLI v2.10 removes Ember.js v1.13 from the default testing matrix in the
+addon blueprint. Given that we now have two LTS releases in the v2.X series of
+Ember.js we no longer feel that supporting Ember.js v1.13 is a reasonable


chancancode · 2016-11-29T07:21:49Z

source/blog/2016-11-28-ember-2-10-released.md

+Ember CLI v2.10 removes Ember.js v1.13 from the default testing matrix in the
+addon blueprint. Given that we now have two LTS releases in the v2.X series of
+Ember.js we no longer feel that supporting Ember.js v1.13 is a reasonable
+default for newly-created addons. You may continue to support Ember.js v1.13 in


chancancode · 2016-11-29T07:22:08Z

source/blog/2016-11-28-ember-2-10-released.md

+In our continous incremental progress toward making `bower` optional inside of
+Ember CLI we have moved to include Ember.js itself via
+[`ember-source`](https://www.npmjs.com/package/ember-source)–provided via `npm`.
+In v2.11.0 we will no longer have any packages provided by `bower` in a brand


chancancode · 2016-11-29T07:22:14Z

source/blog/2016-11-28-ember-2-10-released.md

+new Ember application! Please help us test this by attempting to upgrade your
+applications and reporting any issues you discover, both in your applications
+and in CI using `ember-try`. We want to make sure that the upgrade process to
+Ember CLI and Ember.js v2.11.0 is as smooth as possible.


chancancode · 2016-11-29T07:22:23Z

source/blog/2016-11-28-ember-2-10-released.md

+and in CI using `ember-try`. We want to make sure that the upgrade process to
+Ember CLI and Ember.js v2.11.0 is as smooth as possible.
+
+Ember CLI v2.11.0 will not officially support Node.js v0.12 per the


mixonic · 2016-11-29T07:48:27Z

I've taken the initiative to check off the boxes in the issue description for @nathanhammond and @locks 😬 I'm personally good to go here. ‼️ ‼️ ‼️ GLIMMER2 ‼️ ‼️ ‼️

chancancode · 2016-11-29T07:54:23Z

Looks like Ember CLI hasn't cut the releases yet, unchecked their box for now

GavinJoyce · 2016-11-29T09:05:55Z

source/blog/2016-11-28-ember-2-10-released.md

+
+Thanks to everyone in the community who took the time to test their apps and
+addons against the Glimmer 2 alpha and beta builds, this has been one of the
+most rigorously tested release in the history of the Ember project. We are


...most rigorously tested ~~release~~ releases in the history...

GavinJoyce · 2016-11-29T09:10:24Z

source/blog/2016-11-28-ember-2-10-released.md

+addons against the Glimmer 2 alpha and beta builds, this has been one of the
+most rigorously tested release in the history of the Ember project. We are
+quite confident that upgrade will go smoothly for most apps. However, if you
+encountered any issues, please do report them to the [issue tracker](https://github.com/emberjs/ember.js/issues/).


However, if you ~~encountered~~ encounter any issues

GavinJoyce · 2016-11-29T09:11:51Z

source/blog/2016-11-28-ember-2-10-released.md

+for us, creating a much better foundation for adding new features as well as
+room for future performance impovements. With the initial integration now out
+of the way, we are quite excited to return our efforts to those areas in the
+upcoming releases.


...those areas in ~~the~~ upcoming releases.

jonnii · 2016-11-29T12:10:46Z

source/blog/2016-11-28-ember-2-10-released.md

+[WeakMap](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakMap)
+to [store object metadata](https://github.com/emberjs/ember.js/pull/13783) on
+browsers that supports them. A plesant side-effects of this internal change is
+that Ember no longer add an `__ember_meta__` property to every object.


add => adds

sohara · 2016-11-29T12:43:52Z

source/blog/2016-11-28-ember-2-10-released.md

+Second, thanks to [Robert Jackson](https://github.com/rwjblue), we now use
+[WeakMap](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakMap)
+to [store object metadata](https://github.com/emberjs/ember.js/pull/13783) on
+browsers that supports them. A pleasant side-effects of this internal change is


"side-effects" should be singular.

mixonic · 2016-11-29T13:46:35Z

Perhaps we should mention in the Ember section that one may want to upgrade addons that may have relied in internal APIs when upgrading Ember. And/or list known addons that should be bumped.

diogomafra · 2016-11-30T17:07:25Z

source/blog/2016-11-28-ember-2-10-released.md

+
+#### Move `ds-improved-ajax` out of `beta` channel
+
+The `ds-improved-feature` implemented in


ds-improved-ajax?

I'll check and update :-) Thanks.

igorT reviewed Nov 28, 2016

View reviewed changes

runspired reviewed Nov 28, 2016

View reviewed changes

dgeb reviewed Nov 29, 2016

View reviewed changes

locks commented Nov 29, 2016

View reviewed changes

dgeb reviewed Nov 29, 2016

View reviewed changes

runspired suggested changes Nov 29, 2016

View reviewed changes

xomaczar reviewed Nov 29, 2016

View reviewed changes

chancancode reviewed Nov 29, 2016

View reviewed changes

josemarluedke reviewed Nov 29, 2016

View reviewed changes

chancancode reviewed Nov 29, 2016

View reviewed changes

GavinJoyce reviewed Nov 29, 2016

View reviewed changes

jonnii reviewed Nov 29, 2016

View reviewed changes

sohara reviewed Nov 29, 2016

View reviewed changes

This was referenced Nov 29, 2016

Ember 2.10 Blog Post Items emberjs/ember.js#14600

Closed

Ember 2.11 Blog Post Items emberjs/ember.js#14601

Closed

mixonic changed the title ~~[WIP] Ember 2.10 unified blog post~~ Ember 2.10 unified blog post Nov 29, 2016

mixonic force-pushed the ember-2-10-release branch from 8cc1ebf to aecd5d3 Compare November 29, 2016 22:10

pangratz mentioned this pull request Nov 30, 2016

[FEATURE ds-improved-ajax] Disable feature emberjs/data#4686

Merged

mixonic force-pushed the ember-2-10-release branch from 74ff48c to dc534c0 Compare November 30, 2016 16:53

diogomafra reviewed Nov 30, 2016

View reviewed changes

Create 2016-11-28-ember-2-10-released.md

f435022

mixonic force-pushed the ember-2-10-release branch from dc534c0 to f435022 Compare November 30, 2016 17:09

mixonic merged commit 29b9ba6 into master Nov 30, 2016

mixonic deleted the ember-2-10-release branch November 30, 2016 17:13

		@@ -174,6 +212,14 @@ making rebuilds work for changes in that directory.
		- Stefan Penner [made it so we do a better job at cleanup up on exit of Ember CLI](https://github.com/ember-cli/ember-cli/pull/6423)


		#### Testing Addons

		Ember CLI v2.10 removes Ember.js v1.13 from the default testing matrix in the


		#### Move `ds-improved-ajax` out of `beta` channel

		The `ds-improved-feature` implemented in

Ember 2.10 unified blog post #2727

Ember 2.10 unified blog post #2727

Conversation

locks commented Nov 28, 2016 • edited by mixonic Loading

Draft

Ember

Ember Data

Ember CLI

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

nathanhammond commented Nov 28, 2016

runspired commented Nov 29, 2016

chancancode commented Nov 29, 2016

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

locks commented Nov 29, 2016

mixonic commented Nov 29, 2016

chancancode commented Nov 29, 2016

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

mixonic commented Nov 29, 2016

chancancode commented Nov 29, 2016

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

mixonic commented Nov 29, 2016

Choose a reason for hiding this comment

Choose a reason for hiding this comment

locks commented Nov 28, 2016 •

edited by mixonic

Loading