写点什么

“完成”宣言

  • 2010-03-20
  • 本文字数:1267 字

    阅读完需:约 4 分钟

Alixx Skevington 贴出一篇“完成宣言”以引发讨论,其中谈到团队成员针对各自的工作质量向彼此做出的承诺,并清晰表明了他们对于使用代码交付业务价值的承诺。

他的“完成”条件列表包括:

  • 我会确保我的代码可用。我的代码是为了供他人使用、与他人交互的,我所写的一切都要保证这是令人愉快的过程,而且应该降低工作量,而不是增加。
  • 我会确保我的代码风格服从团队一致同意的风格。未来会是别人,而不是我,来维护和修补我的代码。所以虽然我可以灵活设计并利用任何技术来构建我的解决方案,我还是会遵循标准,以便于其他人将来维护我的代码。
  • 我同意将我的方法保持在合理的大小。大方法难以查看与调试。我会尽量把我的方法保持在合理的大小,以降低复杂度。
  • 我会注释所有的代码。不管是创建新代码还是变更现有代码,我都会写下简明扼要的注释,说明我做了什么。这样其他人在阅读代码时,就能理解我做了什么以及代码试图实现的目的。
  • 我同意对我的代码做单元测试。我同意让这些测试可以重用、足够健壮。我会确保测试说明它测试的对象及其原因。这样其他人在重构或修复 bug 时,不仅可以运行我的测试,还能了解我的代码试图达到的效果。
  • 我同意维护现有代码的单元测试。当我改变或添加现有代码的新功能时,我会确保所有的测试都可以通过,而且新功能也有对应测试。
  • 我同意努力让我的代码的测试覆盖率达到 80%。检查完代码覆盖率,我就可以确保所写的一切代码都有价值,不存在会在未来产生问题的“惊奇代码”。我会努力让覆盖率更高。
  • 我同意正确检查代码的集成状况。当我写完我的代码后,我会和其他开发人员一起检查我的代码,确保与他人的代码可以一起正确工作,交付客户请求的功能。

这个帖子在 LinkedIn 的讨论组中引发了一些评论,人们建议加入更多列表项,比如:

我会加入“我会在签入代码前重新运行单元测试”。原因在于:看起来不相关的代码可能导致另一处的代码及其测试运行失败。这在我上一个工作中多次发生。(来自 David Kramer

再说说单元测试。实际上,我会将其变为“我愿意在编写代码前先编写单元测试”,因为我笃信 TDD。另一点关于测试的是:它们都是生产代码,要以同等态度对待。(来自 Scott Ames

Scott Mcphee 不同意代码注释那一条:

对于代码注释这一条,我坚决持反对意见。注释常常都是谎言,或者不过是引出明显的东西而已(比如: /* 设置 x 等于 y */ x=y;),而且常常增加负担,人们必须要让其与实际代码保持一致。设计清晰、实现清晰的代码不需要“简明扼要的注释说明我做了什么”,从代码就能明显看出它做了什么,而且配置管理提交的注释和代码中的版本差异应该说明写代码的原因。如果做不到的话,就要重构,以做到这一点。API 文档是完全不同的东东,但其主要是给公开方法的用户看的,而不是代码文件的读者,API 文档也是发布交付物的一部分。

Jay Packlick 加入了他认为至关重要的一点:

“完成”最重要的定义是隐含的,但是最值得留意,我愿意把它放在列表的第一条:所有关于“完成”某个功能的验收条件都要以测试表述,而且都要通过。

您愿意对这个列表做出哪些补充或改变?

查看英文原文: A Manifesto of Done

2010-03-20 00:021990
用户头像

发布了 479 篇内容, 共 165.5 次阅读, 收获喜欢 52 次。

关注

评论

发布
暂无评论
发现更多内容

自下而上的问题清单

将军-技术演讲力教练

28天写作

小心!你可能搞了个假的头脑风暴!

Justin

团队协作 28天写作 头脑风暴 群体迷思 创造性思维

学创业,读毛选 Jan 9, 2021

王泰

28天写作 读毛选,学创业

关系中的密码:麻烦

熊斌

个人成长 28天写作 亲密关系

记一次JVM OOM 实战优化

AI乔治

Java 架构 JVM OOM

生产环境全链路压测建设历程 24:FAQ 5、6负载均衡、如何不影响正常业务?

数列科技杨德华

28天写作

HDFS SHELL详解(1)

罗小龙

hadoop 28天写作 hdfs shell

我们为什么要学习Springboot?

武哥聊编程

Java springboot SpringBoot 2 28天写作

三只猫

架构师训练营大作业(一)

曾彪彪

「架构师训练营第 1 期」

CSS10 - 盒子模型&常用无序列表样式

Mr.Cactus

html/css

我能加入写作训练营,一切都因为...

李忠良

个人成长 驱动力量 28天写作

RocketMQ学习笔记

大刘

RocketMQ MQ 消息队列

kill -9 导致 kafka 重启失败的惨痛经历!

AI乔治

Java kafka 架构

第2周总结-架构中的设计模式

潘涛

架构师训练营 4 期

序言 基层管理者技能修炼的九把刀

一笑

管理 28天写作

Flink 自定义Avro序列化(Source/Sink)到kafka中

大数据老哥

大数据 flink hadoop

区块链挖矿系统APP软件开发

系统开发

一致性Hash算法

Andy

大作业一

fmouse

架构师训练营第 1 期

第2周课后练习-OOD的五大原则

潘涛

架构师训练营 4 期

28天带你玩转Kubernetes--第一天(课程介绍)

Java全栈封神

Kubernetes 云原生 k8s入门 28天写作 k8s教程

架构师训练营大作业(二)

曾彪彪

「架构师训练营第 1 期」

架构师训练营第 1 期 - 大作业1

Anyou Liu

架构师训练营第 1 期

解读《Java开发手册(泰山版)》- 会当凌绝顶,一览众山小

xcbeyond

Java Java开发手册 28天写作

在 win 10 上安装 Elasticsearch 7.10.1

escray

elasticsearch elastic 28天写作 死磕Elasticsearch 60天通过Elastic认证考试

区块链的前世今生(1)

抗哥

SafePoint 与 Stop The World 全解(基于OpenJDK 11版本)

AI乔治

Java 架构 jdk JVM

视频号发展简史&第一天数据 | 视频号28天(02)

赵新龙

28天写作

期末大作业(一)

wanlinwang

单向链表合并实战

Andy

“完成”宣言_研发效能_Shane Hastie_InfoQ精选文章