Ditto. The problem is self-reinforcing: people don’t read docs because the docs ...

sshine · 2024-10-23T17:25:03 1729704303

> The problem is self-reinforcing: people don’t read docs because the docs are bad… we don’t spend time on docs because no one reads them…

I don't get discouraged from writing docs because nobody reads them. I'll read them.

But I do experience another similar self-reinforcing problem:

If other people don't read or update my docs, the docs begin to lie.

sshine · 2024-10-20T13:55:49 1729432549

Not only is it self-reinforcing:

It is inevitable because some competent programmers deliberately don’t comment their code, read comments, or delete other people’s comments when they are stale.