RFC

Проблема

Дорогое изменение затрагивает несколько владельцев, но контекст и компромиссы живут в голове автора.

Минимум

• проблема и ставка;
• цели и не-цели;
• ограничения;
• предлагаемое решение;
• реальные альтернативы;
• миграция и откат;
• риски;
• открытые вопросы;
• владелец выбора и срок.

Сигнал успеха

Ревьюеры обсуждают риск и альтернативы, а итог можно восстановить без личного чата автора.

Антисигнал

Реализация готова, а документ нужен только для формального одобрения.

См. главу RFC и ADR и шаблон RFC.