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.
  • Без пустых шаблонов.