News for hackers. Stuff that matters.
Re:AngularJS 1.3: a new release approaches by oomkiller on Saturday December 14, 2013 @05:04PM (#6907301)
Angular's Disqus comments were a perfect example of the hate and entitlement in open source that makes people quit contributing. While they're not the greatest docs, they're quite passable, especially with the rest of the info on the web (videos explaining concepts, egghead.io, etc). On top of that, it is really easy to contribute. I saw a few small doc issues, fixed them, and they were merged within 6 hours. If people could be more civil and constructive, comments would be fine, but I'm glad they're gone.
Re:AngularJS 1.3: a new release approaches by duaneb on Saturday December 14, 2013 @05:43PM (#6907423)
> If people could be more civil and constructive, comments would be fine, but I'm glad they're gone.

So it's better to just ignore the problems with the documentation? I barely have time to learn the framework—the lack of good documentation means I delete it from my hard drive. No matter how good a framework is, if it's not documented well, it's a buggy black box.

Even criticism that doesn't offer a solution is better than a lack of feedback. Besides, it's not like Google will get all self conscious and stop contributing because people don't think the documentation is good.

Re:AngularJS 1.3: a new release approaches by oomkiller on Saturday December 14, 2013 @07:52PM (#6907808)
There are plenty of places to offer feedback on Angular, general or specific. All I'm saying is that it's nice to look at the docs and not have to see a big string of "OMG AngularJS docs suck" (only a slight exaggeration).

Also, if your comment is going to be useful on a documentation page, chances are it will be even more useful as a commit to the docs themselves. Mad about doc quality? Whine (give feedback) about it on Twitter, maybe even mention one of the committers.

Re:AngularJS 1.3: a new release approaches by cbp on Saturday December 14, 2013 @07:07PM (#6907678)
> I barely have time to learn the framework.

If you can't be bothered to deeply study and understand your tools then you probably don't deserve to use them anyway.

Re:AngularJS 1.3: a new release approaches by rhp on Saturday December 14, 2013 @07:29PM (#6907731)
Yeah totally. And if you can't be bothered to read your car's owner's manual from cover to cover you probably don't deserve to be driving it anyway.
Re:AngularJS 1.3: a new release approaches by rch on Saturday December 14, 2013 @08:54PM (#6907973)
Actually, you should probably read the Chilton (or equivalent) manual cover to cover.
Re:AngularJS 1.3: a new release approaches by cbp on Saturday December 14, 2013 @07:56PM (#6907818)
A lack of curiosity is indeed reproachable. And while I do consider knowing how a car works basic common knowledge, I wouldn't advise someone that doesn't have that to start with the manual.
Re:AngularJS 1.3: a new release approaches by duaneb on Sunday December 15, 2013 @03:39PM (#6910762)
> If you can't be bothered to deeply study and understand your tools then you probably don't deserve to use them anyway.

I hadn't even gotten past the evaluation stage. Bad documentation is a huge smell for the rest of the framework—I'm not going to waste my time pursuing a tool that I'm not going to use.

Re:AngularJS 1.3: a new release approaches by subsection1h on Saturday December 14, 2013 @07:18PM (#6907707)
duaneb doesn't have much time to learn one particular framework, so you think he doesn't deserve any tools?

Wha?

Re:AngularJS 1.3: a new release approaches by Helianthus on Saturday December 14, 2013 @08:32PM (#6907913)
This isn't the context of people using Angular the hammer, it's in the context of people trying to learn Angular, the forklift, and all of the forklift users saying "It's not our fault you can't figure it out!"
Re:AngularJS 1.3: a new release approaches by Helianthus on Saturday December 14, 2013 @08:33PM (#6907917)
>Angular's Disqus comments were a perfect example of the hate and entitlement in open source that makes people quit contributing.

This is a perfect example of the entitlement people feel to be free from others' ire or criticism.