erlang - 标签和版本升级的正确顺序

Question

我有一个library在 github 上，它使用了 rebar，但它从未通过 git 进行标记。截至撰写本文时，app.src 文件表明它是版本 0.1(从未更改过)。

我想进行一些提交，这将更改一些函数定义。我需要使用标签和应用程序版本，这样就不会对用户产生负面影响，但我不清楚应该标记、碰撞等的顺序。

我现在和将来要采取哪些步骤来确保用户可以编码到他们选择的版本？

Answer 1

我在我的存储库中使用以下方案:

• X.Y.Z，其中 X 是主要版本，Y 是次要版本，Z 是补丁版本(借鉴了一些想法 Semantinc Versioning )

• 我更改 .app.src 文件和标签的顺序如下:

  1. 进行更改，在 .app.src 文件中添加版本号并使用不错的提交消息。

  2. 使用与 .app.src 文件中相同的版本号提交的标记。我输入一个以下形式的标记消息:

     Version X.Y.Z
     
     - New Feature 1
     - New Feature 1
     - Fix this and that
     

     然后使用我的签名(使用 -s 标志)对标签进行 GPG 签名

  3. 使用 git push && git push --tags 推送提交，将提交和标签上传到服务器。

我不使用语义版本控制的“vX.Y.Z”方案作为标签，因为我认为它是多余的，而且看起来不太好。

一旦您拥有正确的标记和版本控制(您选择的)，您的用户应该能够依赖按原样使用 Git 标记。

您可以在此处查看结果:https://github.com/eproxus/meck (您需要下载代码才能查看标签消息并验证 GPG 签名)。