foundation
Хорошие сообщения коммитов
Пишите сообщения с intent и эффектом, а не только список изменённых файлов.
Хорошее сообщение коммита объясняет **зачем** и **какой эффект**, а не только какие файлы менялись. Типичная структура:
fix(billing): reject duplicate invoice webhooks
Stripe может ретраить webhooks; idempotency key игнорировался на
update path. Добавлен integration test и счётчик метрик.
Fixes #4821
| Часть | Рекомендация | |-------|--------------| | Subject (~50 символов) | Повелительное наклонение, scope по желанию | | Body | Мотивация, компромиссы, заметки о миграции | | Footer | Ссылки на issue, breaking-change |
Changesets и генераторы changelog потребляют качество сообщений.
На интервью: imperative subject, body для неочевидного контекста, ссылки на issue, conventional commits для автоматизации.
Типовые ошибки: subject «fix» или «update»; body повторяет diff; шаблон без реального intent.
Компромисс — дисциплина сообщений против скорости; больше усилий на рискованных и кросс-командных изменениях.
Чеклист:
- Imperative subject с ясным scope.
- Зачем — если контекст неочевиден.
- Issue, миграции, flags.
- Без пустых шаблонов.