It's not a matter of motivation. Programmers reduce the verbal understanding of their work to non-verbal symbolism. That's necessary to work efficiently in long complex projects where many ideas have to be manipulated. It is very distasteful to re-verbalize work that has been reduced to symbolism.
> If you’re taking documentation really seriously, put it on the scorecard. Look for good writers. ... Then put it in your career ladders too. It’s a competency that individuals need to develop if they’re to move to the next level.<p>Exactly. If it's not evaluated and rewarded in the same way shipping code is (in hiring, too, as mentioned), it'll never be treated as important by developers. Devs are generally rational: if you say "write docs!", but then complain when things take longer because they were taking time to write docs, well, then you can guess what will happen.
IME the biggest killers of documentation are:<p>1) no time set aside to keep it up to date.<p>2) the tedium of reflecting changes made in one place in 3 others.<p>3) the fact that the MVP of a lot of organizations is the go to guy who can answer all the questions while amazing documentation is quickly taken for granted & rarely personalized.