Files

1.4 KiB

ADR — записи об архитектурных решениях

Короткие заметки о развилках, где выбор был неочевиден: как сохраняем игру, как устроена сетка, фиксированный тик или переменный. Смысл — сохранить мотивацию решения, чтобы через полгода не восстанавливать её по коду.

Файл на решение, имя — NNNN-краткая-суть.md, нумерация сквозная и не переиспользуется. Принятое решение не переписываем: если передумали — новый ADR со статусом «заменяет NNNN».

Шаблон:

# NNNN. Заголовок решения

- Статус: предложено | принято | заменено (NNNN)
- Дата: ГГГГ-ММ-ДД

## Контекст

Что за задача и какие ограничения заставили выбирать.

## Решение

Что выбрали. Одним абзацем, в настоящем времени.

## Последствия

Что стало проще, что сложнее, за что теперь платим.

## Альтернативы

Что рассматривали и почему отвергли.