掌握聚合最新动态了解行业最新趋势
API接口,开发服务,免费咨询服务

说明变更原因:让Git Commit Message变得更清晰明了

我最近在忙着处理一个第三方整合方面的问题,这个问题突然出现在我眼前,而且没有明显的原因。问题的来源,是页面上的一个iframe突然无法正常工作了。

我的第一反应,就是对包含这个iframe的那行代码进行git blame看看代码上一次改变是在什么时候,以及改变的内容。我立刻就发现了变更:

 - <iframe src="https://fake-3rd-party.com/widget?code=12345" />

+ <iframe src="https://fake-3rd-party.com/embed/WXYZ" />

它意味着,在整合过程中,一个东西可能出现了改变,并且引发了这个问题。于是我开始查看commit message,试图找到更多的信息,我注意到:

 Author: Some Guy <some.guy@some.domain>

    changed iframe src

原来如此!多谢你了,Some Guy

但是故事还没有结束,我才刚刚开始要阐述我的观点。

当我们下次写commit message的时候,让我们花时间想一想,这个messege是否能够提供有用信息?我们是否应该在里面加一些其他的信息,让别人能理解究竟发生了什么?比如一个链接,或是其他能说明问题的东西。

如果你确实不知道应该写什么才能让message变得有用,你不妨问自己一个问题:我为什么要做出这个变更?考虑好这个问题之后,至少你可以将做出这次变更的动机写在message中。至少,在了解了你的动机之后,其他人在进行深一步的调查的时候能更轻松一点。

从现在开始,我们应该将这种为什么要进行变更的内容,写在commit message中。

sdk.jpg

原文来自:SDK.cn

声明:所有来源为“聚合数据”的内容信息,未经本网许可,不得转载!如对内容有异议或投诉,请与我们联系。邮箱:marketing@think-land.com

  • 双人婚姻登记状态核验

  • AI新闻简报

    最新新闻资讯简报,各类国内、国际、体育、娱乐、科技等资讯AI智能总结摘要及详细内容,适合各类AI Agent、穿戴设备进行资讯播报、阅读。

    最新新闻资讯简报,各类国内、国际、体育、娱乐、科技等资讯AI智能总结摘要及详细内容,适合各类AI Agent、穿戴设备进行资讯播报、阅读。

  • 运营商5G基站信息

    通过传递运营商2G/3G/4G/5G基站的MCC、MNC、TAC、CID信息查询所在位置信息。为用户提供位置服务,如实时导航、周边推荐等。

    通过传递运营商2G/3G/4G/5G基站的MCC、MNC、TAC、CID信息查询所在位置信息。为用户提供位置服务,如实时导航、周边推荐等。

  • 人脸实名认证2.0

    通过身份证号+姓名+人脸照片的一致性比对,系统与公安库中的身份证登记照比对,判断是否为同一人,核验用户信息真实性。

    通过身份证号+姓名+人脸照片的一致性比对,系统与公安库中的身份证登记照比对,判断是否为同一人,核验用户信息真实性。

  • 企业招投标信息

0512-88869195
客服微信二维码

微信扫码,咨询客服

数 据 驱 动 未 来
Data Drives The Future