QUOTE(threehair @ 2003-11-14 10:25:45)
我一直认为,人是任何活动中的最重要的因素。
但是任何东西都有两面性。过犹不及。对人、对文档都一样
在软件活动中也一样。但是成也萧和,败也萧和。软件活动中的人太多了,如果没有合适的规范怎么可以规范不同人的活动?只能是一盘散沙而已。如果文档规范过了,同样也不行。
只有合适的才是最好的。
规范重要,但人的需要更重要,程序员是人。男人,女人.......
规范不是写XXXX个文档,而在乎如何协作。 交流通过文档肯定会由种种问题,何不之间面对面的交流? 即使不能面对面的交流,那么,也应该以大家最容易最恰当的方式交流。至于程序员最熟悉的交流方式是什么,我也不说了。好的代码应该不需要XXXX个文档。
下面给个简单的例子,如果让你选择,你写文档嘛?
1----------------
CODE
public class PriceCaculator {
public double caculate(Goods goods,double amount){
.....
}
}
2----------------
商品计算类:PriceCaculator,商品计算类用于计算商品的价格,caculate方法返回值值是商品价格。 goods是商品,amount是商品的数量.............