Я не требую от программистов написания большей части документации - технический писатель стоит втрое дешевле программиста, и, в отличие от него, совсем не демотивируется такой работой. Есть документы, которые может написать только программист, но количество таких документов невелико в сравнении с общим объемом. Для подавляющего большинства документов вклад программиста вполне можно ограничить парой абзацев, консультациями и финальной проверкой.