News for hackers. Stuff that matters.

A comment on The Perks of a High-Documentation, Low-Meeting Work Culture. Parent comment

Re:The Perks of a High-Documentation, Low-Meeting Work Culture by pmoriarty on Tuesday November 22, 2022 @04:31PM (#33711791)
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.

[ Parent | on HN ]
Re:The Perks of a High-Documentation, Low-Meeting Work Culture by bazmattaz on Tuesday November 22, 2022 @05:10PM (#33712261)
Having worked with software engineers for the last 10years I can confirm, most don’t like documentation. At least 80% dont
[ Parent | on HN ]
Re:The Perks of a High-Documentation, Low-Meeting Work Culture by still_grokking on Tuesday November 22, 2022 @07:11PM (#33713348)
Which is a funny statement as almost all devs like to have documentation.
[ Parent | on HN ]
Re:The Perks of a High-Documentation, Low-Meeting Work Culture by nmfisher on Tuesday November 22, 2022 @09:52PM (#33714570)
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.

[ Parent | on HN ]