GitHub. Conventional Commits

🧱 Суть

Conventional Commits – это соглашение по оформлению сообщений коммитов.
Формат:

type: description

Например:

git commit -m "feat: add weather history"

Главная идея: по сообщению коммита сразу понятно, что было изменено и зачем.

📦 Проблема

1. Понятная история проекта

Плохая история:

update
fix
changes
test

Непонятно:

• что изменилось;
• зачем был сделан коммит;
• можно ли его безопасно отменить.

Хорошая история:

feat: add user authentication
fix: handle empty api response
refactor: extract weather service

Сразу видно назначение изменений.

2. Удобная работа в команде

Другим разработчикам проще понимать изменения:

feat → новая возможность
fix → исправление ошибки
refactor → изменение структуры кода

3. Автоматизация

Conventional Commits могут использоваться для:

• генерации changelog;
• автоматического определения версии;
• настройки CI/CD.

Например:

feat:

может означать новый функционал.

fix:

может означать исправление патч-версии.

✅ Решение

Использовать конкретные типы коммитов по соглашению.

Тип	Назначение	Пример
feat	Новая функциональность	feat: add search filter
fix	Исправление ошибки	fix: prevent empty submit
refactor	Изменение кода без изменения поведения	refactor: simplify auth service
docs	Документация	docs: update api guide
style	Форматирование кода	style: format components
test	Добавление или изменение тестов	test: add login tests
chore	Технические задачи	chore: update dependencies

💻 Примеры для frontend-проекта

Новый компонент:

git commit -m "feat: add weather card component"

Исправление бага:

git commit -m "fix: handle api timeout"

Рефакторинг:

git commit -m "refactor: move api logic to service layer"

Изменение зависимостей:

git commit -m "chore: update npm packages"

Документация:

git commit -m "docs: add project setup instructions"

Плохие примеры

fix
update
changes
new version
asdf
minor fixes

Проблема:

• нет контекста;
• непонятно назначение;
• история проекта становится бесполезной.

Правила хорошего коммита

Хороший коммит:
✅ одно логическое изменение
✅ короткое описание
✅ понятный тип изменения
✅ настоящее время

Например:

Хорошо:

feat: add drag and drop for kanban cards

Плохо:

added some stuff for kanban

🎯 Вывод

Conventional Commits помогают:

• поддерживать чистую историю Git;
• быстрее понимать изменения;
• работать удобнее в команде;
• автоматизировать процессы.

Минимальный стандарт:

feat: новая возможность
fix: исправление бага
refactor: изменение структуры кода
chore: технические изменения

🔗 Связано

• GitHub. Работа с коммитами
• GitHub. Названия веток
• GitHub. CICD
• Other. Версионность приложений