исправлены дефекты формулировок в конвенциях
- убраны неверные утверждения: покрытие forbidigo сужено до честного, таблица классов доменного отказа больше не претендует на полноту, механизация не подаётся как факт канона - введены недостающие определения (доменная и внешняя границы, объявление пути), критерий постоянного поля сведён к одному на R16.1 и R17 - kebab-case имени файла убран из правил в прозу: обоснование не формулировалось, номер R16 оставлен свободным
This commit is contained in:
@@ -4,6 +4,17 @@
|
||||
`LANGUAGE.md`. Где и когда ошибку **логировать** — в
|
||||
`lang/go/logging.md` (коротко: лог один раз на доменной границе).
|
||||
|
||||
Две границы, о которых говорят правила ниже:
|
||||
|
||||
- **доменная граница** — место, где определяется исход операции: use-case,
|
||||
публичная команда воркера, стадия асинхронной обработки. Ниже неё ошибка
|
||||
только накапливает контекст, выше — операция уже либо удалась, либо нет.
|
||||
- **внешняя граница** — место, где ответ покидает процесс: обработчик HTTP,
|
||||
рендер страницы, отправка сообщения ботом.
|
||||
|
||||
Одна операция проходит обе: сначала доменную (там её исход логируется),
|
||||
потом внешнюю (там он превращается в ответ).
|
||||
|
||||
## Правила
|
||||
|
||||
### R1. Ошибки строятся средствами стандартной библиотеки
|
||||
|
||||
Reference in New Issue
Block a user