Семантическое версионирование

Семантический подход в версионированию программного обеспечения.

1 Краткое описание семантического версионирования

• Семантическое версионирование описывается в манифесте семантического версионирования.

• Кратко его можно описать следующим образом:

  • Версия задаётся в виде кортежа МАЖОРНАЯ_ВЕРСИЯ.МИНОРНАЯ_ВЕРСИЯ.ПАТЧ.
  • Номер версии следует увеличивать:
    • МАЖОРНУЮ версию, когда сделаны обратно несовместимые изменения API.
    • МИНОРНУЮ версию, когда вы добавляете новую функциональность, не нарушая обратной совместимости.
    • ПАТЧ-версию, когда вы делаете обратно совместимые исправления.
  • Дополнительные обозначения для предрелизных и билд-метаданных возможны как дополнения к МАЖОРНАЯ.МИНОРНАЯ.ПАТЧ формату.

2 Программное обеспечение

• Для реализации семантического версионирования создано несколько программных продуктов.
• При этом лучше всего использовать комплексные продукты, которые используют информацию из коммитов системы версионирования.
• Коммиты должны иметь стандартизованный вид.
• В семантическое версионирование применяется вместе с общепринятыми коммитами (см. Общепринятые коммиты).

2.1 Пакет Semantic-release

• Пакет Semantic-release автоматизирует весь рабочий процесс выпуска программного пакета.

2.2 Пакет Conventional Changelog

• Пакет Conventional Changelog является комплексным решением по управлению коммитами и генерации журнала изменений.
• Содержит набор утилит, которые можно использовать по-отдельности.