This is and will continue to be a challenge for the AngularJS team. While comprehensive, their documentation for complex things like directives seems more contributor-oriented than user-oriented.<p>Fortunately, the users on the Google group are very active and people like John Lindquist[1] are putting out insightful and approachable tutorials.<p>I think that one of the major issues faced by AngularJS from an adoption standpoint is that people see the simple examples on the front page and assume that, while powerful, it is best suited for toy apps. I'm not sure how to address this, but I've seen the perception repeated over and over by potential users who have done a 'surface check' and have then based their conclusion on an incomplete picture.<p>[1]: <a href="http://egghead.io" rel="nofollow">http://egghead.io</a>
I agree with all the points made in this, and it reflects my experiences with building an angularJS app. However, I left with a very positive view of angular, technologies should have a learning curve (rather than a learning wall) and angular is my favorite SPA framework for this reason.
I wish I had known about ui-router before I wasted days trying to hack together nested views /w deep urls:<p><a href="https://github.com/angular-ui/ui-router" rel="nofollow">https://github.com/angular-ui/ui-router</a>