3 ms·
The documentation isn't great but it isn't terrible either. I hope people thinking of giving angular a try aren't put off by the constant over-dramatisation.
by ds_ 13y ago
The documentation isn't great but it isn't terrible either. I hope people thinking of giving angular a try aren't put off by the constant over-dramatisation.
- k__ 13y agoYeah, I don't think the docs are bad, angular is just not a simple concept.
- Cthulhu_ 13y agoAnd their lack of attempts to improve it; I mean, it's an open source project, there's a big "IMPROVE THIS DOC!" button on every documentation page.
- deleted 13y ago[deleted]
- spyder 13y agoMaybe it's because improving the doc has not too much benefit for the contributor because he/she already understands the badly documented problem. But improving code has instant benefit for the contributor because he probably fixing something he still using.
- hysan 13y agoI 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.
- randallsquared 13y agoThis is actually the same answer: when they finally learn enough to fix the documentation, there is no longer any personal benefit to doing so.
- mst 13y agoThis 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.
- hysan 13y agoI 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.