Python论坛的帖子：

Thu Aug 3 21:40:21 HKT 2006

Harry Moo,您好！

	TXT描述的大体架构(包括类关系)和代码
重点中的重点
在开发之前会写一下
架构及数据结构的描述以及一些通用的代码会
其它的函数描述基本上只会在代码里写

======= 2006-08-03 11:49:21 您在来信中写道：=======

>我觉得代码就是最好的设计文档，有完善的注释，清晰的函数名，一目了然的类名。然
>后给些简单文档描述一下大的架构和类层次就OK了。
>基本上，我现在都是用的重构开发，边写边调整，不过我做的项目都不是很大。
>
>说一说我的文档编写历程吧。
>1. 在第一家公司，比较重视文档，写代码前必须写好设计文档，那段时间的确锻炼了
>我的文档编写能力，也接触了很多的软件工程、软件文档方面的书籍和资料。但是写文
>档跟写程序一样，各人有各人的风格，往往相互间还要就文档风格进行争论，并且每个
>人都不太想看人家写的，甚至自己写过的都不想再看了。。。
>2. 在第二家公司，是过了CMM3的，不过过完就完了，没人真的按CMM3走，那样走会死
>人的。。。但是我们使用了迭代开发，而且一直坚持了下来，有位兄弟说他们公司进行
>了一半就停了下来，可能是因为你们做的是项目，客户压力相对较大。迭代开发可能更
>加适合做产品的公司。在这家公司，我的文档明显就写的少了，只有一些大的架构和设
>计上的文档。
>3. 如今的公司，我们很少写文档，即使写也坚决不用WORD、VISIO和RATIONAL这些大软
>件(太慢，用CVS管理也不方便)，我们只用TXT。业务流程、详细设计这些我们就随手在
>纸上画，只是为了帮助理清思路、理解需求和得到设计架构。
>最终，我们保留的就是大概两样东西：TXT描述的大体架构(包括类关系)和代码。
>
>侯捷说的好：代码面前了无秘密。 ：）
>
>-----邮件原件-----
>发件人: python-chinese-bounces at lists.python.cn
>[mailto:python-chinese-bounces at lists.python.cn] 代表 limodou
>发送时间: 2006年8月3日 11:10
>收件人: python-chinese at lists.python.cn
>主题: Re: [python-chinese] [ 谈谈设计]关于详细设计
>
>On 8/3/06, Xiao Lei Wu <xiaoleiw at cn.ibm.com> wrote:
>>
>>
>>
>> 也许你们不相信，不用说中国小公司，在IBM里面也不是所有项目都完全按照流程来
>的，甚至可以说大部分项目不是按照流程来的
>>  比如我现在做的这个项目，FPFS都还没有就开始FVT，甚至是要final
>> regression了,文档都是挤牙膏一样的一点一点往外挤
>>  最开始企图用最新的叠代开发模式,结果搞到一半发现不行,最后还是退回到瀑布模
>式
>> 某些已经成熟使用叠代开发模式的项目,原则上一个月出一个fix，结果领导说，如果
>是USAF这样的客户有紧急apar，可以例外……
>>
>> 最后我想奉劝所有刚毕业的年轻人，不要把技术看得太重，不要对什么"设计"、"框
>架"看得过于神圣，不要唯技术论，在IBM中architect并不是舒适惬意的工作，受到各
>方面的压力非常的大，基本上是不可能按照自己的想法去做事的。毕竟软件是个产业，
>不是基础科学，卖钱是最终目的，因此任何的技术都要为"卖钱"服务，无论在哪个国家
>哪个公司都是这样，除非你去FSF做自由软件
>>
>所以如果有文档与代码结合得非常好的方法还是不错的。文学编程，我看好你呦。
>
>-- 
>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

= = = = = = = = = = = = = = = = = = = =
			

　　　　　　　　致
礼！
 
				 
　　　　　　　　小生
　　　　　　　　newboytim at 163.com
　　　　　　　　　　2006-08-03

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