3 ms·

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

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.

duaneb 13y ago
> 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.
- cbp 13y ago
  > 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.
  - subsection1h 13y ago
    duaneb doesn't have much time to learn one particular framework, so you think he doesn't deserve any tools? Wha?
  - rhp 13y ago
    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.
    - cbp 13y ago
      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.
    - rch 13y ago
      Actually, you should probably read the Chilton (or equivalent) manual cover to cover.
  - Helianthus 13y ago
    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!"
  - duaneb 13y ago
    > 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.
- oomkiller 13y ago
  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.
Helianthus 13y ago
>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.

duaneb 13y ago

> 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.

cbp 13y ago
> 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.
- subsection1h 13y ago
  duaneb doesn't have much time to learn one particular framework, so you think he doesn't deserve any tools? Wha?
- rhp 13y ago
  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.
  - cbp 13y ago
    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.
  - rch 13y ago
    Actually, you should probably read the Chilton (or equivalent) manual cover to cover.
- Helianthus 13y ago
  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!"
- duaneb 13y ago
  > 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.
oomkiller 13y ago
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.

Helianthus 13y ago

>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.