Documentation is worse than code. It's often outdated, difficult to understand a... | Hacker News

Hacker Newsnew | past | comments | ask | show | jobs | submit

		holoduke on Nov 22, 2022 \| parent \| context \| favorite \| on: High-documentation, low-meeting work culture Documentation is worse than code. It's often outdated, difficult to understand and full of useless information. In every company I have been people hate to read docs and nobody wants to maintain them. I am not sure what a good alternative might be.

dist1ll on Nov 22, 2022 | [–]

That's a culture problem. It boils down to documentation being a second-class citizen which is not included in the "definition of done".

KaoruAoiShiho on Nov 22, 2022 | [–]

It just needs to be better than meetings to be well, better than meetings. Nothing is worse than meetings.

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact