@mhoye This is a first-class rant, and I agree entirely.

While I´m not a developer, a large part of my job is translating between techies and everyone else (management, sales, customers, you name it). My experience is:

1. Developers will write the documentation they themselves need.
2. With reviews, coaching and prodding, developers can provide documentation that can be used by other developers.
3. Want better docs? Do it yourself.
4. Want really good docs? Hire a technical writer.