Git & Version Control
Соберите поля или проверьте готовое сообщение. При переключении оба черновика сохраняются.
В списке распространённые типы. Можно ввести собственный.
Начните с Refs: #42 или Closes #42. Обычные следующие строки продолжают предыдущее значение.
Сообщения остаются в браузере. Доступ к репозиторию и отправка по сети не выполняются.
Структура Conventional Commits 1.0.0; без правил проекта и ограничения 50/72 символа. До 20 000 единиц UTF-16.
Введите описание или полное сообщение.
Генератор сообщений коммитов помогает перед созданием коммита отделить краткое описание от подробностей и явно указать несовместимость. «Соглашение о коммитах» придаёт этим частям определённый смысл. Поля конструктора и готовый текст для проверки хранятся раздельно, поэтому переключение не уничтожает черновик. Результат показывает сообщения коммитов и заявленное влияние, но не анализирует изменения исходного кода.
Генератор сообщений коммитов объединяет тип, необязательный контекст и описание в первой строке. Между разделами добавляются пустые строки, а внутренние абзацы сохраняются. Можно увидеть весь текст до вставки в редактор коммита, не заменяя собственный тип и не меняя автоматически регистр букв.
Обычный feat заявляет изменение minor. Знак ! перед двоеточием или корректное примечание о несовместимости меняет заявление на major при любом типе. Так видны изменения, нарушающие обратную совместимость. Это интерпретация текста: инструмент не доказывает, что интерфейс действительно сломан, и не выбирает номер следующего выпуска.
Список содержит подсказки, а не только допустимые значения. Можно ввести собственное название. Выбор между feat и fix требует знания кода: краткое описание само по себе не доказывает, что ошибка исправлена или функциональность добавлена.
Начните, например, с Refs: #42 или Closes #42. Следующая обычная строка продолжает значение; новый корректный токен с разделителем начинает другую запись. Для явного указания раздела используйте поле примечаний, оставляя пояснения в многоабзацном теле.
Автоматическая обработка ждёт 350 мс после последнего изменения. Отключите её для кнопки или Ctrl/Cmd + Enter. Изменение текста, полей или ! сразу блокирует копирование и скачивание, пока текущие данные не будут обработаны заново.
Заголовок включает тип, контекст и однострочное описание. Далее возможны абзацы и примечания. Регистр сохраняется; FEAT и feat имеют одинаковый заявленный смысл для версии. Описание может быть русским. Длина заголовка показана для сведения, а 50 или 72 символа не являются обязательной границей.
Проверяются заголовок, обязательная пустая строка и распознаваемые примечания. Ошибки содержат номер строки и столбца, редактор выделяет строку. URL или двоеточие внутри обычного предложения не делают тело некорректным автоматически. При переключении черновик конструктора остаётся доступен.
Знак ! ставится после типа или контекста непосредственно перед двоеточием; отдельное примечание тогда необязательно. Также поддерживаются BREAKING CHANGE: описание и равнозначный BREAKING-CHANGE: описание. Эти специальные токены пишутся прописными буквами. Значения могут продолжаться на следующих строках.
Допустимы оба варианта. Спецификация требует интерпретировать типы без учёта регистра. Выберите единый стиль в команде. Проверка сохраняет исходное написание, но специальные токены BREAKING CHANGE и BREAKING-CHANGE являются исключением: для них нужны прописные буквы.
По возможности разделите изменения с разными целями на отдельные коммиты. Здесь у сообщения только один тип. В теле можно пояснить контекст, но выбор feat не подтверждает правильность классификации всех изменений. Влияние на совместимость следует проверить отдельно.
fix заявляет patch, feat — minor, а ! или корректное примечание о несовместимости — major. Несовместимость имеет приоритет над типом. Показано только это заявление: текущая версия, предварительные выпуски и правила вашего процесса публикации инструменту неизвестны.
Если это черновик, исправьте тип и повторите проверку. Опечатка вроде feet может оставаться структурно допустимой, поскольку разрешены собственные типы. Редактирование существующего коммита — отдельная задача репозитория; страница не выполняет amend, rebase и не меняет историю.
Спецификация оставляет поведение revert авторам инструментов. Тип revert и примечание Refs могут указывать затронутые коммиты. Проверка принимает такую структуру, но не вычитает влияние предыдущих изменений и не определяет номер версии после отмены.
Есть формат для проверки?
Генератор сообщений коммитов позволяет ещё раз сопоставить заявление с реальным изменением и экспортировать актуальный результат после проверки структуры.