Тут такая интересная дискуссия у вас была по поводу переквалификации разработчиков в технические писатели. Я думаю, что сложнее писать качественную документацию, чем код. Код, который вы написали, пусть даже и корявенько - если он сработает, со всеми своими костылями, пользователь ничего не заметит. О проблемах будут знать только QA и другие разработчики, которые ревьюили pull request. А если вы написали плохую и непонятную документацию, пользователь, на любом уровне, это заметит сразу же.