Выражение показывает HOW, но не всегда сохраняет причину
Имя WHAT вводит самостоятельное предметное понятие. WHY объясняет, зачем решение существует и какое бизнес-различие нельзя потерять.
Слабый комментарий
// Рассчитываем задолженностьОн лишь пересказывает ближайшее выражение.
Сильный WHY
// решение принимается по состоянию после заказаОн фиксирует выбор прогнозного, а не текущего состояния.
WHAT должен быть самостоятельным понятием
WHAT + WHYнаведите на цветной токен, чтобы увидеть его рольMILA
ЗадолженностьПослеОтгрузки
// WHY: решение принимается по состоянию после заказа
= ТекущийДолг + СуммаЗаказа;- WHAT: ЗадолженностьПослеОтгрузки можно обсуждать отдельно от формулы.
- WHY: выбран момент после заказа.
- HOW: текущий долг складывается с суммой заказа.
Перепишите слабое присваивание
Результат = Остаток - Резерв;Сначала назовите предметный результат. Затем добавьте WHY, который объясняет, для какого следующего решения нужен остаток после резерва.
Показать один из возможных вариантов
Возможный ответнаведите на цветной токен, чтобы увидеть его рольMILA
ДоступныйОстатокПослеРезерва
// WHY: отгрузка проверяется по свободному остатку после действующих резервов
= Остаток - Резерв;Самопроверка
- Имя вводит понятие или лишь временное хранилище?
- WHY добавляет причину, которой нет в выражении?
- Можно ли обсудить решение, не повторяя формулу?