The "step by step guide" for angular 2 on angular.io is pretty terrible.

430 views
Skip to first unread message

Jean-Baptiste Cattley

unread,
Sep 22, 2015, 11:16:27 PM9/22/15
to AngularJS
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. 

Anthoni Gardner

unread,
Oct 13, 2015, 6:31:19 PM10/13/15
to AngularJS
Agree with this whole heartedly.
Does anyone know of any good websites / blogs that teach Angular2 ?
I know it's still in alpha / beta, but would like to see how to build an app in A2

Regards
Anthoni

Pawel Kozlowski

unread,
Oct 13, 2015, 6:42:41 PM10/13/15
to ang...@googlegroups.com
Hi!

All the docs for ng2 are being re-worked right now. The re-wamped docs
should be on-line pretty soon (days).

Cheers,
Pawel
> --
> 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 angular+u...@googlegroups.com.
> To post to this group, send email to ang...@googlegroups.com.
> Visit this group at http://groups.google.com/group/angular.
> For more options, visit https://groups.google.com/d/optout.



--
AngularJS book:
http://www.packtpub.com/angularjs-web-application-development/book
Looking for bootstrap-based widget library for AngularJS?
http://angular-ui.github.com/bootstrap/

Anthoni Gardner

unread,
Oct 13, 2015, 7:02:10 PM10/13/15
to AngularJS
Sounds good.
Will keep checking.

Jean-Baptiste Cattley

unread,
Oct 21, 2015, 9:13:51 PM10/21/15
to ang...@googlegroups.com
Great improvement, however I'll note one bug:

<span class="badge">{{hero.id}}</span> {{hero.name}}</a>

Trailing un-opened </a> tag on the code throughout the tutorial 
> You received this message because you are subscribed to a topic in the Google Groups "AngularJS" group.
> To unsubscribe from this topic, visit https://groups.google.com/d/topic/angular/s6kXPb-OFjA/unsubscribe.
> To unsubscribe from this group and all its topics, send an email to angular+u...@googlegroups.com.
Reply all
Reply to author
Forward
0 new messages