Rework Ember API documentation discussion
Rework Ember API documentation discussion

Instead of putting the legacy imports first, emphasize the modern import
syntax and shift the discussion of the legacy imports to a secondary
explanatory mode. Emphasize that new apps should only use modern imports
and that old apps should migrate to them.
ember-learn/ember-api-docs,ember-learn/ember-api-docs