github - 向包中添加示例时是否应该更新 semver 版本？

Question

我正在制作一个 npm 包并将其发布为 1.0.0 版，因为我对公共(public) API 很满意。但是现在，我正在添加一个“示例”子项目来展示如何使用该库。显然，我不会将示例项目作为库的一部分发布(它将添加到 .npmignore 中)，但它会在我的 github 存储库中。是否有任何语义版本控制规则？我应该更新补丁版本、次要版本还是什么都不更新？

一方面，我认为我不应该更新版本，因为它不会发布到 npm，因此应用程序的普通用户甚至不会注意到包中的差异。另一方面，semver 规则规定在更改文档时应更新“补丁”或“次要”版本，即使文档也未发布。

Answer 1

relevant spec here is #3 :

3. Once a versioned package has been released, the contents of that version MUST NOT be modified. Any modifications MUST be released as a new version.

由于您的 API 中没有添加任何内容，而且这显然不是重大更改，因此您应该修改补丁号。