Re:On launching AngularJS 1.2: what we learned, what we're c...
by hysan on Tuesday November 26, 2013 @09:07AM
(#6801256)
I think the simpler answer is that most people who complain about documentation cannot improve the docs because they don't know how. If they did understand what was being explained in the documentation, they wouldn't be complaining in the first place.
[ Parent
| on HN ]
Re:On launching AngularJS 1.2: what we learned, what we're c...
by randallsquared on Tuesday November 26, 2013 @09:35AM
(#6801441)
This is actually the same answer: when they finally learn enough to fix the documentation, there is no longer any personal benefit to doing so.
Re:On launching AngularJS 1.2: what we learned, what we're c...
by hysan on Tuesday November 26, 2013 @10:58AM
(#6802046)
I was trying to make the distinction between those who get to the level of competence of contributing vs those who don't reach that point. The former group being people who don't complain about the docs (or at least not as loudly) while the latter group does. But I guess I didn't get that across clearly, sorry.
Re:On launching AngularJS 1.2: what we learned, what we're c...
by mst on Tuesday November 26, 2013 @09:58AM
(#6801628)
This is why my projects have always been willing to cut a deal with newbies to exchange stupid question credits for doc patches - i.e. "if you feel X is underdocumented, the core team will happily give you a personal tour of X provided you write up the results for the next guy to read" - which tends to help the incentive problem.