如何对Code Review的评论进行分级

我曾写过一篇关于Code Review的文章《Code Review 最佳实践》,在文章中建议对Code Review的评论进行分级:

建议可以对Review的评论进行分级,不同级别的结果可以打上不同的Tag,比如说:

  • [blocker]: 在评论前面加上一个[blocker]标记,表示这个代码行的问题必须要修改

  • [optional]:在评论前面加上一个[optional]标记,表示这个代码行的问题可改可不改

  • [question]:在评论前面加上一个[question]标记,表示对这个代码行不理解,有问题需要问,被审查者需要针对问题进行回复澄清

类似这样的分级可以帮助被审查者直观了解Review结果,提高Review效率。

 

当时只是简单的建议分成三个级别:Blocker、Optional和Question,今天看到Netlify的一篇文章《Feedback Ladders: How We Encode Code Reviews at Netlify》,讲到了在Netlify是如何对Code Review的反馈进行阶梯划分的,同时还配有形象的Emoji图标,非常值得学习借鉴。

 

在这里我简单介绍一下Netlify是如何对Code Review反馈进行分级的。

 

⛰ 大山,严重问题,必须马上采取行动

如果说你的代码是房子,那么这座山⛰️就长在你的房子里面,房子已经被撑破没有空间了,在做其他事情之前必须立即把山给搬了。

 

⛰️属于最高级别的反馈,问题可能不仅仅是当前PR(Pull Request,合并请求)导致的,而是发现在master的代码有非常严重的问题,属于非常严重并且必须马上修改的级别。

 

比如说在Review时发现了正在运行的程序中存在的安全漏洞和导致系统崩溃的严重Bug。

 

🧗‍♀️ 巨石,严重问题

如果说你的代码是房子,那么🧗‍♀️就像是堵在房子门口的巨大石头,非常严重,你不能出门。当然如果你有更紧急的事情,可以先处理更紧急的事情,比如厨房漏水了。

 

🧗‍♀️巨石属于严重的问题,不修复当前的PR不能获得批准,但是不影响其他工作任务。

 

比如说发现当前PR会导致程序性能下降。

 

⚪️ 鹅卵石,不严重,但是需要后续改进

如果说你的代码是房子,⚪️就像你房间地板上的鹅卵石,不影响你的正常生活,但是很烦人,可以等有时间的时候清理掉

 

⚪️属于问题不严重,不影响当前PR的合并,但需要在未来某个时间解决。而且通常这种情况下,最好是在合并PR前,创建一个Ticket来后续跟踪,避免问题不了了之!

 

比如说在你的PR中,一个颜色有细微的差别,或者漏写了几个测试,那么可以先通过PR,后续再改进,但是最好要创建Ticket跟踪后续改进。

 

⏳ 沙子,不严重,但是需要有后续的思考

如果说你的代码是房子,那么⏳就像是房间的沙子,你要考虑一下是不是值得清理一下。当然如果你的房子本身就是在沙滩旁边,无论怎么及时清理也总会有沙子跑进来,那么你就没必要时时清理,但是有必要跟你的同事解释清楚。

 

⏳属于问题不严重,不影响当前PR的合并,但是需要技术负责人考虑是不是需要后续行动,或者做出进一步解释。

 

比如说在你的PR中,有人建议对代码重构一下以提高可读性。

🌫 灰尘,无关紧要,可做可不做

如果说你的代码是房子,那么🌫就像是房间的灰尘,有人认为值得清理,有人觉得无所谓。

 

🌫属于可有可无的问题或者建议,不影响PR的合并。后续可做可不做。

 

比如说在你的PR中,有人对于代码风格和命名上的一些建议。

 

总结

上面就是对于代码审查的分级,从山⛰️到大石头🧗‍♀️到小石子⚪️到沙子⏳最后到灰尘🌫,很形象也很实用。

 

下次你在给团队做代码审查的时候,不妨尝试用上面的分级方式对你的反馈进行分级,这样被反馈的团队成员就很容易知道反馈的级别,从而快速的做出相应的反应。

 

 

 

 

 
posted @ 2020-05-06 07:47  宝玉  阅读(1278)  评论(1编辑  收藏  举报