4 ms·
Ditto. 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…
by ks2048 2y ago
Ditto. 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…
- sshine 2y agoNot 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.
- 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.