Re:Ask HN: What frustrating things do you wish someone would...
by glimcat on Sunday October 30, 2011 @06:43PM
(#3175623)
Crappy documentation.
[ Parent
| on HN ]
Re:Ask HN: What frustrating things do you wish someone would...
by buss on Monday October 31, 2011 @02:22AM
(#3176562)
Yeah, I feel you. Unfortunately, I don't think it's possible to tackle this without a fundamental shift in the development community. Self-documenting code is practically a fallacy, and people forget that we're supposed to write code primary for other humans to read, and only incidentally for computers to execute.
I wonder if a marketplace for documentation development would help the problem. This might not work, however, since writing documentation requires a good amount of familiarity with the code base.