Software engineers love to code and are usually less keen on maintaining documentation. Therefore, it’s usually hard to keep documentation up-to-date. The most common problems I see with software-related documentation are outdated content and poor structure. While it’s possible for engineers to improve in these areas, to reach a good level of quality you need to have a dedicated person focusing on this task, such as a technical writer.
Like with code, documentation requires clear rules, templates, and a well-defined review process. Where technical documentation is primarily written by engineers, the best way to keep it in good shape may be to treat it as code. You should have a design guideline, follow patterns and best practices and define who will take the lead and outline a vision. https://goo.gl/x3Jtt8