大家对文档什么看法？

xcmissyou

文档是一定要写的，要不到时候自己都不知道了。。。

aero

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

这样是过了，我们公司就这样搞，很多时候很影响效率。

但也和员工对待这些东西的态度有关系，即使这样，仍然有人不守规矩。

aero

原帖由 MMMIX 于 2007-4-25 16:36 发表

代码 review 是必要的，但这个公司做的好像有点走火入魔。一些简单的修改，例如说拼写错误的修改完全可以直接 check-in。如果三不管的这样搞，那么最后这一套要么成为走过场，要么严重影响效率，浪费资源。

我靠，太TMD准确了。

flw2

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

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

可是这个不是我写的，我没有办法。真的，你不知道，再说，这个东西确实不需要，代码写的也不错。

flw2

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

我这里提交，经常（我不知道什么情况）会要求这样的字段
fix bug bugid
然后才能

我修改的代码不能叫fix  bug，不过我这样写

fix bug 0: no bug ,nobug

makeit

受教了

xiaoquqi

文档还是不可或缺的 但是如何让文档成为有一种有效驱动项目的工具 是一个问题
怎么去写好文档 真的是一门学问呀

飞灰橙

请教大家除了Docbook以外，还有其他统一文档格式的办法？
Docbook实在用的太不爽了

Edengundam

原帖由 飞灰橙 于 2007-4-26 15:50 发表
请教大家除了Docbook以外，还有其他统一文档格式的办法？
Docbook实在用的太不爽了

飞灰再用openjade的sgml嘛???

飞灰橙

原帖由 Edengundam 于 2007-4-26 15:51 发表



飞灰再用openjade的sgml嘛???

不用，我在cygwin下用xsltproc通过xsl转换将docbook转成html,
在用javascript调用Word.Application将html转成统一格式的word文档