Python论坛的帖子：

Thu Aug 3 16:37:52 HKT 2006

有时我宁可重做，也不想去看文档，分析原来的程序．．．

可能你花在上面的时间比重做还长．．

计划没有变化快．文档跟不上代码速度．当我去看文档时，发现已经过期．

  ----- Original Message ----- 
  From: yao qu 
  To: python-chinese at lists.python.cn 
  Sent: Thursday, August 03, 2006 3:51 PM
  Subject: Re: 答复: [python-chinese] [ 谈谈设计]关于详细设计


  我感觉Harry Moo说的是关于开发的文档，这样做的话也可以，不过比较大的项目我就不大肯定这样可以了。但是开发完这个项目之后呢，如果开发的这批人走了，或者到其他位置上，不负责开发了，那新来的人如何继续这个项目呢，老师傅来带？那熟练的程序员的劳动力就要用到这个地方而不是开发，或者不主要是开发。这样的成本和文档的成本哪个比较高？我觉得这才是问题所在。


  在06-8-3， limodou <limodou at gmail.com> 写道：
    On 8/3/06, Harry Moo <mobing at gmail.com> wrote:
    > 我觉得代码就是最好的设计文档，有完善的注释，清晰的函数名，一目了然的类名。然
    > 后给些简单文档描述一下大的架构和类层次就OK了。
    > 基本上，我现在都是用的重构开发，边写边调整，不过我做的项目都不是很大。
    > 
    > 说一说我的文档编写历程吧。
    > 1. 在第一家公司，比较重视文档，写代码前必须写好设计文档，那段时间的确锻炼了
    > 我的文档编写能力，也接触了很多的软件工程、软件文档方面的书籍和资料。但是写文
    > 档跟写程序一样，各人有各人的风格，往往相互间还要就文档风格进行争论，并且每个
    > 人都不太想看人家写的，甚至自己写过的都不想再看了。。。
    > 2. 在第二家公司，是过了CMM3的，不过过完就完了，没人真的按CMM3走，那样走会死 
    > 人的。。。但是我们使用了迭代开发，而且一直坚持了下来，有位兄弟说他们公司进行
    > 了一半就停了下来，可能是因为你们做的是项目，客户压力相对较大。迭代开发可能更
    > 加适合做产品的公司。在这家公司，我的文档明显就写的少了，只有一些大的架构和设
    > 计上的文档。
    > 3. 如今的公司，我们很少写文档，即使写也坚决不用WORD、VISIO和RATIONAL这些大软
    > 件(太慢，用CVS管理也不方便)，我们只用TXT。业务流程、详细设计这些我们就随手在 
    > 纸上画，只是为了帮助理清思路、理解需求和得到设计架构。
    > 最终，我们保留的就是大概两样东西：TXT描述的大体架构(包括类关系)和代码。
    >
    > 侯捷说的好：代码面前了无秘密。 ：）
    >
    代码少，或短的确没有问题。有些代码非常大，怎么看。如果有一个指南性的代码阅读的东西自嵌在里面不是挺好。看到zoom.quiet讲解的leo，就已经有人把阅读过的内容通过leo给组织起来了，即可以看到整体性的东西，还可以就某一点看到具体的内容。非常好。 

    --
    I like python!
    My Blog: http://www.donews.net/limodou
    My Django Site: http://www.djangocn.org
    NewEdit Maillist: http://groups.google.com/group/NewEdit

    _______________________________________________
    python-chinese
    Post: send python-chinese at lists.python.cn
    Subscribe: send subscribe to python-chinese-request at lists.python.cn
    Unsubscribe: send unsubscribe to  python-chinese-request at lists.python.cn 
    Detail Info: http://python.cn/mailman/listinfo/python-chinese


------------------------------------------------------------------------------


  _______________________________________________
  python-chinese
  Post: send python-chinese at lists.python.cn
  Subscribe: send subscribe to python-chinese-request at lists.python.cn
  Unsubscribe: send unsubscribe to  python-chinese-request at lists.python.cn
  Detail Info: http://python.cn/mailman/listinfo/python-chinese
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.exoweb.net/pipermail/python-chinese/attachments/20060803/10a17c81/attachment.html

标题：[python-chinese] [谈谈设计]关于详细设计