DOC: filter recordArrays must be deleted

[stefanpenner]

#4041 suggest that we must improve documentation around how and when to cleanup recordArrays.

[oliw]

In case this helps shape your Dos and Donts this is how I'm cleaning up my record Arrays

  model() {
    let serviceRegionIds = this.paramsFor('service-region-group').service_region_group_id.split(',');
    return this.store.filter('chat-participant', participant => serviceRegionIds.includes(participant.get('serviceRegionId')));
  },

  deactivate() {
    // Ember Data #4041 - store#filter/store#query RecordArrays
    // are never garbage collected
    const model = this.get('controller.model');
    model.destroy();
  }

[runspired]

We've moved to deprecate filter

• Deprecate Package ember-data/ember-data-filter#16
• Ember data filter deprecation rfcs#326

[runspired]

we no longer have filtered record arrays at all.