News for hackers. Stuff that matters.

A comment on Free software is suffering because coders don’t know how to write documentation. Parent comment

Re:Free software is suffering because coders don’t know how ... by klodolph on Friday June 02, 2017 @03:00PM (#14472481)
> It's just that the creator didn't go the last 5% of the way to explain to someone else how.

We software developers have this borderline criminal tendency to undervalue work that isn't software development, like writing documentation. I'd say that documentation might be closer to 20% of the work of a project, and developers are usually bad at it (by "bad" I mean "unskilled").

[ Parent | on HN ]
Re:Free software is suffering because coders don’t know how ... by franciscop on Friday June 02, 2017 @03:12PM (#14472578)
A -quite old[1]- estimate puts it in 20-40% of the total time should be spent writing documentation. If you find any newer reference please let me know, I'd love to quote it in my project to write project's documentation [2].

[1] http://www.techrepublic.com/blog/10-things/10-things-you-can...

[2] https://documentation.agency/

[ Parent | on HN ]