Оглавление
Git
Соглашение по именованию коммитов
Каждый коммит должен содержать в себе описание изменений, по которому должно быть чётко понятно зачем и что было сделано.
Сам формат опционален и может быть разным на разных проектах в зависимости от используемых технологий и требований, однако рекомендуется, чтобы каждый коммит содержал в себе:
- тип изменений, который содержит коммит;
- область кода, в которой производились изменения;
- сообщение;
- описание, как правило пишется через пустую строку от заголовка коммита. Может содержать более подробное описание изменений, важное замечание, ссылку на задачу, к которой коммит относится.
Допустимые значения типов могут меняться от проекта к проекту. Основными типами являются:
- feat - новый функционал;
- fix - исправление ошибок;
- docs - изменения в документации;
- style - форматирование кода и правки кодстайла;
- refactor - изменения в коде, которые не влияют на поведение;
- test - изменения в тестах;
- ci - изменения в CI/CD;
- perf - оптимизации скорости работы;
Если задача существует в JIRA, то коммит следуем именовать следующим образом – [номер задачи и проект из JIRA]: [название задачи]. Это позволит JIRA автоматически связать merge request с задачей.
# 😊 Хорошо: коммит описывает изменения и проект, который он затрагивает
feat(@maxus/gaming): добавлен новый компонент base-slider
# 😊 Хорошо: коммит создан под JIRA
SITE-17286: Раздел Мой профиль в ЛК
# 💩 Плохо: не понятно что и где меняется
добавлен новый компонент base-slider