We are not writing enough documentation. The documentation we write are not solving the problems we are trying solve with it. Mostly, this is a consequence of not being deliberate and mindful about how we approach writing documentation.
[Diataxis](https://diataxis.fr/) provides a structured approach to documentation design that I support.
Documentation is a kind of automation. Rather than CPUs as execution engines, you use your users.
An old adage is that documentation will always be outdated, and thus it is not worth writing it.
I think documentation will always be outdated, and incomplete. That just doesn't matter. There is still value in providing contextual and conceptual information.
And even outdated or wrong documentation will provide guidelines to understand the current state of the world.