35 lines
1.4 KiB
Markdown
35 lines
1.4 KiB
Markdown
# ADR — записи об архитектурных решениях
|
|
|
|
Короткие заметки о развилках, где выбор был неочевиден: как сохраняем игру, как
|
|
устроена сетка, фиксированный тик или переменный. Смысл — сохранить мотивацию
|
|
решения, чтобы через полгода не восстанавливать её по коду.
|
|
|
|
Файл на решение, имя — `NNNN-краткая-суть.md`, нумерация сквозная и не
|
|
переиспользуется. Принятое решение не переписываем: если передумали — новый ADR
|
|
со статусом «заменяет NNNN».
|
|
|
|
Шаблон:
|
|
|
|
```markdown
|
|
# NNNN. Заголовок решения
|
|
|
|
- Статус: предложено | принято | заменено (NNNN)
|
|
- Дата: ГГГГ-ММ-ДД
|
|
|
|
## Контекст
|
|
|
|
Что за задача и какие ограничения заставили выбирать.
|
|
|
|
## Решение
|
|
|
|
Что выбрали. Одним абзацем, в настоящем времени.
|
|
|
|
## Последствия
|
|
|
|
Что стало проще, что сложнее, за что теперь платим.
|
|
|
|
## Альтернативы
|
|
|
|
Что рассматривали и почему отвергли.
|
|
```
|