Hacker News Reader

The biggest mistake they've made with Angular is that they're using a custom documentation system that's also written in Angular and JavaScript.

The DSLs would be okay to work with if they were better documented and had better examples and an easy to use docs system.

They did at least used to have a discussion/comments section on each documentation page, which I often found at least as useful as the actual docs.

And then they removed them, because, umm, maybe they were too useful, who knows! :(