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>