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

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…


> 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.


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.




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

Search: