the real reason is that, no incentives. your manager will never give you a raise because you wrote nice documentations, in fact, he/she might think you're wast

the real reason is that, no incentives. your manager will never give you a raise because you wrote nice documentations, in fact, he/she might think you're wasting time for not doing bugfixes or features development. as long as documentation of code becomes one factor to evaluate the developers, with rewards somehow, things will change immediately. I never felt doc is a technical problem, it's purely management for this one, it has been neglected for too long.