Комментарии 4
Спасибо за статью. Интересная, но что ж так вы пишете тяжело? Сократить можно было раза в 2-3 статью, если убрать воду
Мне кажется эта статья про то, как вы сокращаете этап ревью и согласования требований к продукту, а не про ревью документации.
В статье вы описали, какие разделы вы включаете в свою документацию, и как это помогает вашим заказчикам лучше вас понимать и быстрее согласовывать требования.
Но это же по сути не согласование документации, это согласование требований.
Как технический писатель я ожидала что в статье с вашим заголовком будет какая-то фишка про сам процесс ревью документации. Например, если бы вы написали, как договорились оставлять комментарии в гуглодоке, и запретили больше двух раз ревьюить одно и то же, заголовок соответствовал бы теме статьи.
PS Аналогию с котиком не поняла тож :(
Спасибо за проявленный интерес к статье. Да, статья больше про содержание (как требований, так и технической документации, которая описывает систему и развивается вместе с ней), а не про инструменты ревью. Про котика, казалось, очевидно: читатель должен понимать логику писателя, чтобы писатель не выглядел как котик, выбирающий коробку вместо мягкой пушистой удобной лежанки.
Почему котику лучше в коробке, или Как мы сокращаем этап ревью и согласования документации