3 ms·
> 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 discoura
by sshine 2y ago
> 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.