Ответ
В моей практике мы используем гибридный подход, сочетая Agile-документацию с ключевыми традиционными артефактами:
- User Stories/Epics (Jira/Confluence) - основной формат требований
- API документация (Swagger/OpenAPI) для интеграций
- ADR (Architecture Decision Records) - для значимых технических решений
- Wiki-страницы (Confluence) с:
- Онбордингом
- Глоссарием терминов
- Схемами интеграций
- Runbook (операционные инструкции)
- Чеклисты релизов
Пример минимального ADR:
# 2024-01-15 Миграция на PostgreSQL
## Контекст
Устаревшая СУБД вызывает проблемы с производительностью...
## Решение
Выбрана PostgreSQL 15 с кластерной конфигурацией...
## Последствия
+ Поддержка JSONB
- Требуется обучение команды