Проведение проектного ревью: срок обсуждения, ответственный за решение и записанный итог

Цель

Принять решение по письменному техническому предложению в известный срок, зафиксировав решение и причины, без формального одобрения на автомате и бесконечного обсуждения. Здесь рассматривается процесс вокруг документа; его написание описано отдельно.

Предварительные условия

Предложение в общем пространстве с возможностью комментирования, постановкой проблемы, альтернативами и открытыми вопросами; командная договорённость о том, кто решает в какой области; журнал решений — ADR или аналог.

Шаги

1. Назначьте принимающего решение при открытии предложения: одного человека для этой области или небольшую поимённо определённую группу. PEP 1 делает это через PEP-Delegate, записанного в заголовке документа и имеющего право одобрить или отклонить этот PEP; процесс Rust назначает соответствующую подкоманду.
2. Объявите срок комментариев с конечной датой (например, неделя; процесс Rust отводит на заключительное обсуждение десять календарных дней) и список людей, чья проверка обязательна, в отличие от просто желательной.
3. Рецензенты комментируют документ, а не чат; автор отвечает на каждую существенную ветку изменением или объяснением. Ветки, переходящие в проектирование, переносят в раздел «нерешённые вопросы» предложения.
4. После обсуждения компромиссов принимающий решение объявляет заключительный срок комментариев: короткое заранее объявленное окно, в котором каждый может высказать последнее возражение. README Rust описывает это как «предложение перейти к заключительному обсуждению» (FCP) вместе с предлагаемым исходом: влить, закрыть или отложить.
5. По окончании окна принимающий решение фиксирует итог и причины, в том числе какие возражения были отклонены и почему. Отложить — допустимый исход, сопровождаемый условием повторного рассмотрения.
6. Составьте ADR по принятому итогу; на документ предложения дайте ссылку, не копируйте его.
7. Для повторного открытия нужна новая информация, указанная в запросе; «меня тогда не было» новой информацией не является.

Ожидаемый результат

Предложения доходят до решения за предсказуемое время; разногласия видны в записи, а не в кулуарных беседах; отклонённые предложения не возвращаются без изменений.

Ограничения и основание проверки

Процессы масштаба языкового сообщества имеют много заинтересованных сторон и длинные сроки; приведённые шаги сокращают роли и окна до уровня команды, причём сроки для команды предложены агентом-автором, а не взяты как число из источника. Назначенный принимающий решение работает только тогда, когда команда заранее принимает такое делегирование.