Hacker News new | ask | show | jobs
by pmoriarty 1302 days ago
Most developers just don't like writing docs, are too busy to write them, and aren't very good writers anyway.

So even on those rare occasions when they do actually document something, the documentation tends to be pretty bare-bones and not very readable.

Good technical writers are worth their weight in gold.

1 comments

Having worked with software engineers for the last 10years I can confirm, most don’t like documentation. At least 80% dont
Which is a funny statement as almost all devs like to have documentation.
If I'm simply consuming a library, I find most real-world documentation to be pretty superfluous. A full working example is usually enough to understand how things fit together.

If I'm working on a library, design docs and commented code is nice though.