大家对文档什么看法？

redac

另一方面, 文档写得非常少的情况下，即使写得很精辟, 也往往不能说明问题
个人的感觉: 文档绝对是一把真正的双刃剑, 把握不好很容易伤到自己的, 并且对
项目的成功无助

aero

原帖由 redac 于 2007-4-25 13:23 发表
另一方面, 文档写得非常少的情况下，即使写得很精辟, 也往往不能说明问题
个人的感觉: 文档绝对是一把真正的双刃剑, 把握不好很容易伤到自己的, 并且对
项目的成功无助

嗯，认识很深刻。支持一下。

上学做笔记，开发写文档，一个道理嘛。

assiss

文档是非常非常重要的，有些时候比代码更重要。
没有文档的代码、程序，实在是太难使用了。

我觉得文档是越详细越好，函数库如果有说明＋例子程序，会让开发轻松很多。

rxpmcb

哦...

gnap

犀牛帖！

rxpmcb

原帖由 gnap 于 2007-4-25 15:10 发表
犀牛帖！

新名词，什么意思？

gnap

原帖由 rxpmcb 于 2007-4-25 15:18 发表

新名词，什么意思？

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

koolcoy

原帖由 redac 于 2007-4-25 13:17 发表


貌似正确而已, 一般在国内这样说的人, 往往没什么实际经验
还是支持flw的说法

文档--还是随需应变的好: 不一定每个程序都要扩展, 都要做成产品, 都要
长期让别人维护的... ...

不同意, 复杂的代码今天写完明天就不能一眼看明白. 是自己看不明白.

flw

众位牛人不要再高来高去了好不好，讨论点儿具体的吧。
比如我知道有个公司，开发人员不能随便往 svn 上面 check-in 东西，非要写什么“修改请求单”，一并附上本地工作副本和基准代码之间的 diff，再找至少两个工程师 review，然后还必须在真实的运行环境进行测试，完了再等主管研发的老总批准了才能 check-in——————哪怕只修改页面上的一个单词拼写错误也得要这样。

gnap

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

这个公司牛，把SVN当成评估专家组来对待。