node.js - npm パッケージの readme を更新するときのバージョンバンプ?

Question

維持している npm パッケージの readme を変更した場合、package.json でバージョンを上げて、別の npm パブリッシュを行う必要がありますか? または、バージョンバンプなしで readme を更新する別の方法があります。

score 41 · Accepted Answer

「する必要がある」の定義に応じて、これは 2 つの非常に異なる質問になる可能性があります。

npm publish --force受け入れられた回答（バージョン番号の一部をインクリメントせずに更新する）は、Q2に対する適切な回答です。しかし、私はQ1に対処したい.

の使用npm publish --forceは推奨されません。代わりに、作成者はsemverとしても知られるセマンティックバージョニングを使用することをお勧めします。

... XYZ (Major.Minor.Patch) のバージョン形式。API に影響を与えないバグ修正はパッチバージョンをインクリメントし、下位互換性のある API の追加/変更はマイナーバージョンをインクリメントし、下位互換性のない API の変更はメジャーバージョンをインクリメントします。

したがって、私の答えは次のとおりです。技術的には、バージョンバンプなしで変更を公開する方法はありますが、それを行うべきではありません。パッケージの API に影響を与えないマイナーな編集については、「パッチ」バージョンを 1.2.0 から 1.2.1 に上げる必要があります。

score 2 · Accepted Answer

npm publish --forceバージョン番号がレジストリにすでに存在する場合は上書きされます。

score 2 · Accepted Answer

あなたができる最善のことは次のとおりです。

新しいマイナーバージョンを発行します。

npm publish [@<scope>/]<name>[@<your new minor version>]

これを行うときは注意してください。パッケージを非公開にすると、24 時間が経過するまで再公開できなくなります。

そのバージョンを空白のままにして、パッケージを非公開にすることができます (ただし、これを行う前にその意味を理解してください)。npm unpublish [@<scope>/]<name>[@<version>]

注: この--force引数は非推奨です。