We have embarked on an interesting experiment to use a social media platform and a community approach to make our enterprise software documentation more up-to-date, accurate and relevant.
We definitely have found a divergence between writing styles of technical writers versus developers, QA folks, consultants etc.
We also are finding that varying incentive systems get in the way to creating the best possible documentation in an agile fashion. Developers mostly are incented to develop code in time and scope, technical writers to deliver style guide compliant documentation.
We do however see that the only effective way forward is a co-creation model, to lower the cost of understanding our products, and increase knowledge discovery effectiveness.