RFC #0395 - Tracking for @ember-data packages

[kategengler]

RFC #0395 - Tracking for @ember-data packages

Champion: @runspired

---

Ember Data Team:

• convert to monorepo
  🔒 @HeroicEric [FEAT packages] Convert to monorepo for RFC #395 data#5919
• publish new packages
  🔒 @runspired as part of 3.10 -beta
• update blueprints to use new packages
  🔒 @runspired [CHORE blueprints] move blueprints into their appropriate packages data#6045
• mappings for use by codemods and lint rules
  🔒 @dycriller https://github.com/ember-data/ember-data-rfc395-data
• provide codemod for converting from DS. to new structure
  🔒 @dcyriller
• provide codemod for converting from ember-data/ to new structure
  🔒 @dycriller
• introduce a lint rule deprecating use of DS. and ember-data/ imports
  🔒 @dycriller
• provide mechanism to test "canary" builds
• eliminate usage of DS. namespace in yuidoc comments in favor of correct package names/imports

Learning Team:

• update docs and guides to reflect new import locations (guides-source have 60 results in 9 files of import DS from 'ember-data') Work for 3.10 or 3.11 - update code blocks to reflect new import paths for ember-data packages ember-learn/guides-source#740
• check API docs data generation to see if they are created correctly. Is anything getting dropped? Needed for 3.10 or 3.11 - Verify that Ember Data's API docs work correctly for the monorepo, and fix issues data#6016 and #740
• fix any issues from ^^^^ Needed for 3.10 or 3.11 - Verify that Ember Data's API docs work correctly for the monorepo, and fix issues data#6016
• Optional - write a test to check the ember-data docs, in the same way as is done in ember.js repo Add tests to check for breaking changes to the API docs data#6017
• update the "mental models" presented in the Ember Data guides content
  Work for 3.10 or 3.11 - update "mental model" of ember-data ember-learn/guides-source#741

Ember CLI Team

N/A

[runspired]

I've introduced a label for tracking issues and PRs related to this effort in ember-data here: https://github.com/emberjs/data/labels/TRACK-packages

[runspired]

Note that we missed the 3.10 release target for this in part due to the continued need to validate/update documentation and documentation generation. We will need to make this a key focus for the 3.11 cycle to ensure we can release packages then.

cc @jenweber for some insight on how we can help on this.

[kategengler]

@runspired If you can serialize the tracking here too, that'd be great. The checklist enables seeing progress of the RFC.

[jenweber]

@runspired I think maybe what we should do is pair the docs generation testing. It's helpful to have some people on the data team who are familiar with it, in order to help speed up future refactors too and protect against dropping things. Can you ask the team if anyone would like to pair it with me or maybe @sivakumar-kailasam, if he's available? We can get this locked down for 3.11. I don't expect any major issues.

If you want to give it a try solo, the linked issue has the instructions (emberjs/data#6016). I think they are fairly complete, though I have never done the API docs app viewing for ember data before, only ember.js.

[jamescdavis]

Guides update started in ember-learn/guides-source#814