Working through the guide in order, from a fresh install of node:
* Compilation of app.ts fails with: src/app.ts(1,42): error TS2307: Cannot find module 'angular2/angular2'.
* Getting this to work properly requires 'tsd install angular2' to be run - which is mentioned, but not until after the reader is told to compile.
* In "Displaying Data" - the reader is instructed to create show-properties.html, containing just one line: <display></display>, instead of the full HTML boilerplate from the previous example with <my-app> changed to <display>
* All the code examples abbreviate previous annotation lines to "...", making it unclear to the reader that annotation lines need to be comma-separated
* It's not clear (until the end of the page) that the FriendsService class goes in the same file as the DisplayComponent class; for people coming from other frameworks/environments, this is not at all obvious.
And that's only up to the second page...
C'mon guys, these docs fail grandmother testing at the first hurdle.