IT managers of the world... wake up. Insist on proper embedded documentation so it never gets separated from the code and then give people time to do it right. Then insist on code reviews and make them part of everyone's job using pay reviews as enforcement. If you lose a couple of programmers because of it, good... they needed to be replaced anyway.
And remember... "If you want it real bad, you'll probably get it that way."
This is more about intellectual property transfer than documentation because I can give you ten pages of documentation without the three lines needed to implement what I am working on. It takes very little to keep a developer happy but companies sometimes have paid team members doing nothing, writing useless compiled code, working on manager's pet project reinventing the wheel. I find most large projects are useless without a few people in the team and if these people are marginalized so they move on the project is dead.
Kind regards,
Gift Peddie