在大型应用程序存储库上实现功能时，我应该提供哪些 git 标签名称和描述？

Question

以与我的问题相关的分支和提交消息为例：

当我处理功能时，我将我的分支命名为 feat/featureName
当我想测试一些东西时，我检查我的junk/nameOfTest分支
当我提交时，我会应用 7 rules of a great commit message

综上所述，我是否可以遵循一种模式来编写好的 git 标签 names 和描述在每个人都在自己的功能上工作的巨大回购中？

例如如果我使用 "user groups" 功能，在我创建基本 CRUD 的地方提交 10 次之后，我应该 tag 它与 v0.1-alpha-groups 并在 描述中 我现在应该列出所有可用的控件吗？

请给我一些好的例子git标签命名和描述最佳实践。

Answer 1

你可以考虑使用semver2 (Semantic Versioning)来命名标签。

之后，你可以查看“Command-line tips for effective release announcements”，里面有一些很好的提示，包括发行说明制作：

If your release isn't large, your release notes could include a summary of the contained commits; this is useful for minor point releases. You can use git shortlog to do this:

$ git shortlog 0.5..0.6 --no-merges
David Winterbottom (661):
      Add defaults to the counts on the product summary dashboard page
      Tidy up urls.py and settings.py
      Use mirrors when pip installing the demo site
      Install django-oscar-stores
      Add link to stores page in footer
...

You can even use --format to provide links to Github commits:

$ git shortlog 0.3.4..0.4 --no-merges --format="%s (https://github.com/tangentlabs/django-oscar-stores/commit/%h)"

This won't always be appropriate if your release if there are thousands of commits.

您在“Very Easy Changelogs with Git”中有类似的方法：

git log 1.0.0...1.1.0 --pretty=format:'<li> %s &mdash; %cn &bull; <a href="http://github.com/<username>/<repo>commit/%H" target="_blank">%h</a></li>' | grep -v Merge > changelog.html

在大型应用程序存储库上实现功能时，我应该提供哪些 git 标签名称和描述？

What git tag names and description should I give when implementing a feature on a big application repo?

git

tags

annotate