在 DVCS 中维护 Changelog.txt 文件

发布于 2024-10-19 10:16:14 字数 238 浏览 1 评论 0原文

我正在开发一个使用大量分支的 git 项目。在大多数情况下,这是一个非常棒的工作流程。我很高兴在分支之间进行合并,喜欢能够挑选代码,以及 git 和其他 dvc 附带的整体生命周期。

我有一个非常痛苦的痛点。如何维护changelog.txt。

我发现每当我进行合并时都会很痛苦(changelog.txt 经常发生冲突),并且当挑选提交时,我意外地设法拾取了真正不需要的更改。

我很想看到这个问题的一个好的答案。

I'm working on a git project that uses lots of branches. For the most part, this has been a really great workflow. I'm happy merging between branches, love being able to cherry-pick code, and the overall lifecycle that comes with git and other dvcs's.

I've got one pain point that is really hurting. How to maintain a changelog.txt.

I've found it hurts whenever I do a merge (the changelog.txt often conflicts), and when cherry-picking commits I've accidentally managed to pickup changes that really weren't desired.

I'd love to see a good answer to this problem.

如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。

扫码二维码加入Web技术交流群

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

评论(1

清晰传感 2024-10-26 10:16:14

一旦您准备好发布软件的新版本,您可以注释您的签入评论并解析这些评论(我想这是提供变更日志的最常见用例)。

评论可以通过以下方式构建(显然只有那些属于确实修改了值得注意的内容的提交):

WHAT WHERE DESCRIPTION

其中 WHAT 可以是

  • FIX 用于错误修复
  • CHG 表示更改
  • NEW 表示新代码

WHERE 应该是一个描述模块的单词,其中 WHAT 已完成。根据这两个信息,您可以提供详细描述修改的 DESCRIPTION

准备好发布后,获取自上一个版本以来的日志并解析它们。可以使用 git log tagname_of_last_version.. 获取日志。有关输出和过滤选项,请参阅 git log 的手册页。

You could annotate your checkin comments and parse these comments once you're ready to ship a new version of your software (I guess that's the most common use case for providing a changelog).

The comments could be built the following way (obviously only those belonging to commits that do modify something noteworthy):

WHAT WHERE DESCRIPTION

Where WHAT could be

  • FIX for bug fixes
  • CHG for changes
  • NEW for new code

WHERE should be one word describing the module where WHAT was done. Following these two informations, you provide your DESCRIPTION describing the modification in deep.

Once you're ready to ship, get the logs since the last version and parse them. The logs can be obtained using git log tagname_of_last_version... See the man page of git log for output and filtering options.

~没有更多了~
我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
原文