An addon geared towards making Ember upgrades easier by allowing you to work through deprecations without massive console noise.
This README outlines the details of collaborating on this Ember addon.
Upgrading Ember versions (especially from 1.12 to 1.13) can be very daunting. One of the largest factors is the massive console.log noise that the deprecations
introduced in those versions (to help us know what we need to do to stay up to date) is so overwhelming that we quite literally have no idea what to do.
The "deprecation spew" issue became very obvious as we progressed into the later 1.13 beta releases. At that point, @mixonic and @rwjblue came up with a wild scheme to create a new way to handle deprecations (this addon's process).
The initial steps needed to get started:
- Install the ember-cli-deprecation-workflow addon.
- Run your test suite.
- Run
deprecationWorkflow.flushDeprecations()from your browsers console. - Copy the string output into
config/deprecation-workflow.jsin your project.
Once this initial setup is completed the "deprecation spew" should be largely "fixed". Only unhandled deprecations will be displayed in your console.
Now that the spew has settled down, you can process one deprecation at a time while ensuring that no new deprecations are introduced.
What does that individual deprecation workflow look like?
- Change one entry in
config/deprecation-workflow.jsfromsilencetothrow. - Run your tests or use your application.
- Errors will be thrown for just that one deprecation, and you can track down the fixes needed in relative isolation of the rest of the deprecations.
- Once the deprecation has been dealt with, remove its entry from
config/deprecation-workflow.js. - Lather and repeat.
Details on contributing to the addon itself (not required for normal usage).
git clonethis repositorynpm installbower install
ember server- Visit your app at http://localhost:4200.
ember testember test --server
ember build
For more information on using ember-cli, visit http://www.ember-cli.com/.