Ember Data Deprecation Guide

[HeroicEric]

We need your help 😄

The Ember guides have a great section with details about deprecated features for Ember itself and we should definitely now have the same for Ember Data.

As you can see below, there is quite a bit of work to do in order to make sure we cover all of the deprecations that have occurred throughout all of the Ember Data 2.x releases.

What We Need From You

1. Pick a deprecation from the list below.
2. Post a comment in here letting everyone know what you're planning to work on
   so we don't accidentally duplicate effort.
3. Make a PR to the emberjs/website repo adding your deprecation to the Ember
   Data Deprecation Guide.
4. Make sure your PR links back to this issue so we can track it.

Deprecation Format

### Deprecations Added in Ember Data <VERSION>

#### <TITLE>

###### until: <DEPRECATED UNTIL VERSION>
###### id: <DEPRECATION ID>
###### feature: <feature flag (if applicable)>

<DETAILS>

Tips

• Try to provide an explanation for why the change was made. If you're not sure, try asking in #ember-data on the Ember Community Slack.
• Provide links to the docs where relevant.
• Provide a before and after example when possible.

Deprecations added in 1.13

• DS.Store#filter should probably be moved out of codebase into the addon
  link

Deprecations added in 2.3

• ember-application.injected-container
• ds.defaultValue.complex-object (:lock: @HeroicEric) Add ember-data deprecation guide website#2741
• ds.rest-serializer.deprecated-key-for-polymorphic-type commit (:lock: @HeroicEric) Add deprecation guide for RESTSerializer.keyForPolymorphicType website#2755

Deprecations added in 2.4

• ds.errors.registerHandlers

The following are only kinda sorta maybe deprecated for now. See #4694

• ds.errors.add link
• ds.errors.remove link
• ds.errors.clear link

Deprecations added in 2.6

• ds.serializer.normalize-hash-deprecated (🔒 @romulomachado) Add deprecation guide to RESTSerializer.normalizeHash website#2742

Deprecations added in 2.7

• ember-data.global-ds (🔒 @romulomachado) Add deprecation for using the global version of DS website#2743
• ds.ember.date.parse-deprecate (:lock: @HeroicEric) Add deprecation guide for Ember.Date.parse website#2745
• ds.date.parse-deprecate (:lock: @HeroicEric) Fix ember data Date.parse deprecation guides website#2748
• ds.serializer.rest.queryRecord-array-response (:lock: @HeroicEric) Add deprecation guide for queryRecord array responses website#2747

Deprecations added in 2.11

• ds.store.recordIsLoaded (🔒 @romulomachado) Add guide to ember-data deprecations for version 2.11 website#2744
• ds.store.lookupAdapter (🔒 @romulomachado) Add guide to ember-data deprecations for version 2.11 website#2744
• ds.store.lookupSerializer (🔒 @romulomachado) Add guide to ember-data deprecations for version 2.11 website#2744

Deprecations Added in Pending Features

[FEATURE] ds-overhaul-references

• ds.references.has-many.push-array (:lock: @HeroicEric) Add deprecation guide for ds-overhaul-references website#2758
• ds.references.has-many.push-invalid-json-api (:lock: @HeroicEric) Add deprecation guide for ds-overhaul-references website#2758
• ds.references.belongs-to.push-record (:lock: @HeroicEric) Add deprecation guide for ds-overhaul-references website#2758

[FEATURE] ds-improved-ajax

• ds.json-api-adapter.ajax
• ds.json-api-adapter.ajax-options
• ds.rest-adapter.ajax
• ds.rest-adapter.ajax-options

[FEATURE] ds-deprecate-store-serialize

• ds.store.serialize (:lock: @HeroicEric) Add deprecation guide for DS.Store.serialize website#2757

[FEATURE] ds-check-should-serialize-relationships PR

• ds.serializer.private-should-serialize-has-many (:lock: @HeroicEric) Add deprecation guide for JSONSerializer._shouldSerializeHasMany website#2756

[FEATURE] ds-payload-type-hooks

• ds.json-api-serializer.deprecated-model-name-for-relationship (:lock: @HeroicEric) Add deprecation guide for ds-payload-type-hooks features website#2769
• ds.json-api-serializer.deprecated-model-name-for-resource (:lock: @HeroicEric) Add deprecation guide for ds-payload-type-hooks features website#2769
• ds.json-api-serializer.deprecated-model-name-for-polymorphic-type
• ds.json-api-serializer.deprecated-payload-type-for-model (:lock: @HeroicEric) Add deprecation guide for ds-payload-type-hooks features website#2769
• ds.json-api-serializer.deprecated-payload-type-for-belongs-to (:lock: @HeroicEric) Add deprecation guide for ds-payload-type-hooks features website#2769
• ds.json-api-serializer.deprecated-payload-type-for-has-many (:lock: @HeroicEric) Add deprecation guide for ds-payload-type-hooks features website#2769
• ds.json-serializer.deprecated-type-for-polymorphic-relationship
• ds.rest-serializer.deprecated-model-name-for-polymorphic-type
• ds.rest-serializer.deprecated-model-name-for-polymorphic-type

Deprecations that need to be added

• JSONAPISerializer#modelNameFromPayloadKey
• JSONAPISerializer#payloadKeyFromModelName
• JSONSerializer#modelNameFromPayloadKey
• JSONSerializer#payloadKeyFromModelName

[romulomachado]

Just did some work on 2.6's ds.serializer.normalize-hash-deprecated. emberjs/website#2742

[romulomachado]

Incoming PR for 2.7's ember-data.global-ds.

[romulomachado]

Incoming PR for 2.11's deprecations.

[runspired]

@romulomachado y u so awesomez?

[romulomachado]

@runspired

[HeroicEric]

Thanks for getting the ball rolling @romulomachado! 🙌

[runspired]

I believe I can categorize this as:

• completed (for the most part)
• unnecessary (for removed feature flags)
• too late (for things now removed in 3.x)