Если я изменяю свой readme для пакета npm, который я поддерживаю, мне нужно, чтобы он ударил версию в package.json и сделал еще один выпуск npm? или есть другой способ обновить readme без обновления.
Версия bump при обновлении readme для пакета npm?
Ответ 1
В зависимости от вашего определения "необходимости" это могут быть два очень разных вопроса:
-
[Можно ли публиковать изменения readme, не нажимая номер версии?]
-
[Технически возможно публиковать изменения без увеличения версии]
Принятый ответ (обновление через npm publish --force, т.е. без увеличения части номера версии) является хорошим ответом на Q2. Но я хочу обратиться к Q1.
Использование npm publish --force не рекомендуется. Вместо этого авторам рекомендуется использовать семантическое управление версиями aka semver, которое предписывает:
... формат версии X.Y.Z(Major.Minor.Patch). Исправлены ошибки. влияя на API, увеличивают версию патча, обратно совместимую Добавления/изменения API дополняют второстепенную версию и назад несовместимые изменения API увеличивают основную версию.
Итак, мой ответ: Несмотря на то, что существует технически способ опубликовать изменения без обновления, вы не должны этого делать. Для незначительных изменений, которые не влияют на API-интерфейс пакета, вы должны указывать версию "patch", например. от 1.2.0 до 1.2.1.
Ответ 2
npm publish --force будет перезаписываться, если номер версии уже существует в реестре.
Ответ 3
Вы можете отменить публикацию:
npm unpublish [@<scope>/]<name>[@<version>]
но это уже невозможно publish --force, поскольку оно устарело. Единственное, что вы можете сделать, кроме этого, - опубликовать новую небольшую версию. Здесь подробно обсуждается: http://blog.npmjs.org/post/77758351673/no-more-npm-publish-f
Ответ 4
Для других, кто приземляется здесь и думает, что они сделали это правильно. Да, вы сделали это правильно; Проверьте страницу npm через 5-10 минут.