写点什么

“完成”宣言

  • 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:021832
用户头像

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

关注

评论

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

我用ChatGPT写互联网职场黑话!

FN0

openai ChatGPT

进行软件开发,需要掌握什么知识和技能?

SoFlu软件机器人

推荐一款好用的数据一致性校验工具

NineData

MySQL 数据一致性 数据校验 IDC SqlServer

‘区块链’3M互助模式系统开发技术(源码搭建)

I8O28578624

考研失败,加入国企当程序员,真香!

程序员晚枫

程序员 找工作 考研 国企

js对象和原型、原型链的关系

hellocoder2029

JavaScript 前端

得物供应链复杂业务实时数仓建设之路

得物技术

数据库 大数据 技术架构

融云「百幄」系列产品,两组套件、三类价值赋能政企八大业务场景

融云 RongCloud

产品 办公 百幄

ChatGPT到底有多贵?| 社区征文

AIWeker

人工智能 openai GPT ChatGPT

微信 + ChatGPT = 自己的智能助手 | 社区征文

IT蜗壳-Tango

ChatGPT

从0到1,亿级消息推送的稳定性保障 | 得物技术

得物技术

稳定性 消息推送

一文读懂NodeJs知识体系和原理浅析

coder2028

架构实战营模块二作业

null

nodejs实现jwt

coder2028

JavaScript 前端

阿里前端二面常见面试题汇总

coder2028

JavaScript 前端

在MWC 2023,华为创新解决方案点亮F5.5G时代的每一处光

脑极体

MWC

极客时间运维进阶训练营第八周作业

忙着长大#

webpack配置完全指南

Geek_02d948

JavaScript 前端

社招中级前端笔试面试题总结

Geek_02d948

JavaScript 前端

文心一言的蝴蝶振翅,云计算的飓风狂飙

脑极体

云计算

js异步编程的三种模式

hellocoder2029

JavaScript 前端

云上贵州:基于鲲鹏DevKit快速开发智能运维平台,性能提升75%

Geek_2d6073

2023前端vue面试题(边面边更)

yyds2026

Vue 前端

基于 docker-compose 部署 SkyWalking包含halo和jenkins案例

忙着长大#

Skywalking

校招前端二面经典面试题(附答案)

hellocoder2029

JavaScript 前端

webpack高级配置

Geek_02d948

JavaScript 前端

美团前端常考面试题(必备)

Geek_02d948

JavaScript 前端

有哪些前端面试题是面试官必考的

coder2028

JavaScript 前端

三天吃透Redis面试八股文

程序员大彬

redis java

那些高级前端是如何回答面试题的

hellocoder2029

JavaScript 前端

前端监控稳定性数据分析实践 | 得物技术

得物技术

前端 前端监控 客服业务

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