You want to write the specs so that everybody does in fact know what this piece of code is doing, and you're writing it each time around.

但是你得养成良好的习惯和编程风格,你得撰写规范说明从而保证,每个人都知道这段代码是干什么的。

麻省理工公开课 - 计算机科学及编程导论课程节选