大家对文档什么看法？

rxpmcb

原帖由 flw 于 2007-4-25 15:54 发表
众位牛人不要再高来高去了好不好，讨论点儿具体的吧。
比如我知道有个公司，开发人员不能随便往 svn 上面 check-in 东西，非要写什么“修改请求单”，一并附上本地工作副本和基准代码之间的 diff，再找至少两个工 ...

太严谨了

flw2

我为我们同事写的一个程序添加功能，一共才有500行代码。
里面最复杂的事情就是一些联表的操作。可是我改了5天才加上我的100行代码。

我相信如果有文档告诉我这个程序要干什么。我从写也不要5天。

MMMIX

原帖由 flw2 于 2007-4-25 17:13 发表
我为我们同事写的一个程序添加功能，一共才有500行代码。
里面最复杂的事情就是一些联表的操作。可是我改了5天才加上我的100行代码。

我相信如果有文档告诉我这个程序要干什么。我从写也不要5天。

那么你可以趁这个机会把文档补上。

flw2

原帖由 MMMIX 于 2007-4-25 17:24 发表

那么你可以趁这个机会把文档补上。

哦，对哦，可是这个不是我写的,经理也没有说要啊，到是补充了一个别的文档。

cjaizss

原帖由 flw 于 2007-4-25 15:54 发表
众位牛人不要再高来高去了好不好，讨论点儿具体的吧。
比如我知道有个公司，开发人员不能随便往 svn 上面 check-in 东西，非要写什么“修改请求单”，一并附上本地工作副本和基准代码之间的 diff，再找至少两个工 ...

。。。这个公司已经到了变态的地步

MMMIX

原帖由 flw2 于 2007-4-25 17:27 发表
哦，对哦，可是这个不是我写的,经理也没有说要啊，

这下你了解了前一个程序员的想法了吧？

flw

原帖由 MMMIX 于 2007-4-25 17:31 发表

这下你了解了前一个程序员的想法了吧？

而且更巧的是，flw2 的下一任将会用刚才他评价上一任同事的话来评价他。

assiss

如果有比文档更重要的事，当然要优先考虑了。
但这不能作为评价文档重不重要的标准。

svn/CVS本身的功能就已经提供了diff、日志、存档等多方面的功能，实在没必要在中间加一道手续。
FLW所说的那家公司的现象，与其说是对程序员要求多，不如说是以此来约束主管－－他们的方式，逼得主管不得不去看提交的代码，而如果用SVN自动管理的方式，主管可能就会偷懒。

MMMIX

原帖由 flw 于 2007-4-25 17:42 发表

而且更巧的是，flw2 的下一任将会用刚才他评价上一任同事的话来评价他。

此即所谓今人笑古人，后人复笑古今人。

UnixStudier

原帖由 gnap 于 2007-4-25 15:21 发表


吸牛，前面看到了很多牛人。

犀牛帖子
------学习了
呵呵