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. 

-- 
You received this message because you are subscribed to the Google Groups 
"AngularJS" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/angular.
For more options, visit https://groups.google.com/d/optout.

Reply via email to