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

При разработке собственных проектов (API, модулей, библиотек и т.д.) возникает проблема присвоения версии проекту. Хорошее решение предложил Том Престон-Вернер.

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

• 12 — мажорная версия;
• 1 — минорная версия;
• 892 — патч.

При изменении мажорных версий производятся большие изменения, которые не совместимы с предыдущими версиями, например, меняются наименования методов или их функциональность. Если меняется минорная версия, то означает, обычно, добавление новой функциональности НЕ мешающей текущей, например, в API добавился новый метод получения данных. А патчи применяются, в большинстве случаев, для исправления ошибок, причем, они также как и минорные версии не должны ломать обратную совместимость с предыдущими версиями.

Все правила и рекомендации находятся на официальном сайте — semver.org/lang/ru.