Bad documentation is not a writing problem. It is a prioritization problem.

Developers know what the code does. They wrote it. The issue is that explaining it to someone else — clearly, without assuming context, at the right level of detail — requires a different mode of thinking than building it did. So it gets deprioritized. The README stays...