Обновлять ли версию npm пакета при незначащих изменениях?

Question

[NikKoster]

Я создал npm пакет версии 1.0.0
После этого сделал несколько коммитов с мелкими незначащими правками по оформлению:
- в readme файле
- документация (JSDoc) в js файле

Нужно ли мне после этого обновлять версию npm пакета? Какие общие правила на данный счет?

Answer 1

[Константин Китманов]

Нельзя опубликовать изменения вне новой версии — npm просто не даст.

Мелкие изменения, не ломающие обратную совместимость, меняют третью циферку в версии, то есть у вас должно быть 1.0.1. А общие правила гуглятся по словам semantic versioning.

Comments

[NikKoster]

Нельзя опубликовать изменения вне новой версии — npm просто не даст.

Это понятно. Я в git репозитарии сделал несколько изменений и прежде чем поменять версию пакета задался текущим вопросом про смену версии пакета.

Мелкие изменения, не ломающие обратную совместимость, меняют третью циферку в версии...

Просто в большинстве мануалов указано про смену третей цифры, когда что-то багфиксится, а про изменения доки как-то не очень.

[Константин Китманов]

NikKoster,

Просто в большинстве мануалов указано про смену третей цифры, когда что-то багфиксится, а про изменения доки как-то не очень.

Это один из вариантов, да. Но в semver третья цифра означает -- улучшения, не ломающие обратную совместимость и не вводящие новых фич.
В принципе, документация это тоже часть кода, и ошибки в ней это тоже ошибки:)

[Алексей Болгов]

Константин Китманов, здравствуйте. Можете глянуть и помочь в моем вопросе?
Как запретить использовать скрипты и ссылки в nodejs?