Angular Logo

Upgrading from Angular beta to Angular RC is a little painful, and things are going to break. I’ve put together some links that helped reduce some of that pain for me.

A few weeks ago, I had the pleasure of upgrading a client’s singe page application from Angular 2.0.0-beta.12 to Angular 2.0.0-rc.4. As soon as I updated package.json, it broke. I was not surprised, I figured this would happen. Unfortunately, there were more than a few things to fix. Fortunately, the fixes fell into three categories:. 1) The Angular namespace changed. 2) The router changed. 3) Unit tests had to be changed.

None of this was fun, but I got through it. The hardest part was the lack of documentation. I found plenty of out-dated articles with tons of information that was useless to me. Awesome. But the official documentation was minimal to none. And what I found was either tedious  or virtually useless. C’mon ng-folks, you can do better than that.

Here are some links that did provide helpful content for this upgrade:


angular/CHANGELOG.md at master · angular/angular

https://github.com/angular/angular/blob/master/CHANGELOG.md

Details: Essential information for each version release. I can’t imagine living without this. In particular, you can find out about namespace changes.


Forms Upcoming Change Proposal

https://docs.google.com/document/u/1/d/1RIezQqE4aEhBRmArIAS1mRIZtWFf6JxN_7B4meyWK0Y/pub

Details: Explains the thought-process behind their change to forms. At the very bottom of the article is critical information about how to opt-in to the deprecated forms, or use the new forms module.


Issues after Migration to RC4 in angular2 – Stack Overflow

http://stackoverflow.com/questions/38154399/issues-after-migration-to-rc4-in-angular2

Details: Some helpful information on breaking changes.


Routing & Navigation – ts

https://angular.io/docs/ts/latest/guide/router.html

Details: A very detailed explanation of how the new router works. A long read, but also one of the few thorough their documentation pages.


Defining Child Routes · Rangle.io : Angular 2 Training

http://angular-2-training-book.rangle.io/handout/routing/child_routes.html

Details: Another very detailed explanation of how the new router works.


Plunker

https://plnkr.co/edit/6Mdn7qUblMtktpQyFJAc?p=preview

Details: This plunker is very helpful if you need a quick-and-dirty working example of how child routes work in the new router.