Кейс: спецификация, которую никто не читает

Сначала спрошу разработчиков и тестировщиков, что мешает: часто проблема в том, что нужное спрятано среди общего текста. Перестрою документ: наверху цель и краткое описание изменений, дальше сценарии, бизнес-правила таблицей, контракты API ссылкой на OpenAPI, диаграммы вместо абзацев, примеры запросов и ответов. Убираю копии того, что живёт в других местах. Ввожу совместный разбор спецификации на refinement: 30 минут разговора экономят дни переписки. Смотрю на метрику: сколько вопросов и багов возникает из-за требований. Объём важен меньше, чем то, насколько быстро человек находит нужное.