pennyliang (好好学习，天天向上，学习刘翔好榜样) 于Thu Sep 30 09:24:05 2004)
提到：
这段时间渐渐体会了老板说的话“代码就是最好的文档”，如果写出的代码象是在讲
故事，而且娓娓道来，那么这个代码我想一定是好代码。
realfun (知天知地知彼易◎知己难) 于Thu Sep 30 09:31:06 2004)
提到：
瞎掰，稍微大点儿的代码不可避免的接触到计算机独有的知识
不懂计算机的人看得懂的不过是那些拿出来show的小程序而已
【 在 pennyliang 的大作中提到: 】
: 这段时间渐渐体会了老板说的话“代码就是最好的文档”，如果写出的代码象是..
: 故事，而且娓娓道来，那么这个代码我想一定是好代码。
Roach (chen3feng) 于Thu Sep 30 10:03:30 2004)
提到：
像白居易一样讲给文盲老太太，如果她能懂，就恭喜你啦
【 在 pennyliang (好好学习，天天向上，学习刘翔好榜样) 的大作中提到: 】
: 这段时间渐渐体会了老板说的话“代码就是最好的文档”，如果写出的代码象是在讲
: 故事，而且娓娓道来，那么这个代码我想一定是好代码。
pennyliang (好好学习，天天向上，学习刘翔好榜样) 于Thu Sep 30 10:44:09 2004)
提到：
是啊，那要很高的境界。
代码关键在于逻辑关系，每个人讲话做事都具有很强的逻辑关系，先做什么后做什么
，什么更好等等，所以不懂计算机的人的逻辑能力常常足够高明，完全可以接受代码所体
现的逻辑。
多年前的机器语言，到汇编，到C,到面向对象，语言变得越来越和现实世界紧密联系
而脱离了机器的复杂性，例如HTML语言很难看到什么文件操作，内存分配。。。
以前写程序不注意临时变量，函数，类的命名，代码可读性很差，有时候就是在命名
的时候可以思考很多，如果一个类很难命名也许这个类作的事情太多了，那么就应该分解
。
如果一个变量名可以讲述太代表的意义，一个函数名都可以体现自己的含义，那么实现这
些理想还是有可能的。
【 在 Roach 的大作中提到: 】
: 像白居易一样讲给文盲老太太，如果她能懂，就恭喜你啦
: 【 在 pennyliang (好好学习，天天向上，学习刘翔好榜样) 的大作中提到: 】
cxx (no nickname) 于Thu Sep 30 11:07:17 2004)
提到：
如果中文写的让不懂中文的人看懂就是好的中文了？
试着写个让街道的大妈看懂的quick sort.
【 在 pennyliang (好好学习，天天向上，学习刘翔好榜样) 的大作中提到: 】
: 这段时间渐渐体会了老板说的话“代码就是最好的文档”，如果写出的代码象是在讲
: 故事，而且娓娓道来，那么这个代码我想一定是好代码。
innersmile (innersmile) 于Thu Sep 30 11:27:27 2004)
提到：
对真正要写代码的人来说,也许“代码就是最好的文档”,
但是要让不写程序的人来说,代码对他们来说没有意义,
他们看不懂也不想去看或者说没有必要去看, 他们有兴趣
可以去看文档. 而且他们对文档的可读性要求会很高,
这时候像一些继承关系, UML图之类的可能显得更加清楚,
不懂程序的人但是逻辑分析强的人对着图表跟他稍微解释
一下就会有个一目了然的效果.
【 在 pennyliang 的大作中提到: 】
: 这段时间渐渐体会了老板说的话“代码就是最好的文档”，如果写出的代码象是..
: 故事，而且娓娓道来，那么这个代码我想一定是好代码。
pennyliang (好好学习，天天向上，学习刘翔好榜样) 于
提到：
没有这个意思啊，我的意思是，不懂计算机的人是那些懂得英语的人，而且受过良好教
育的非计算机专业的人。街道大妈当然不算在内了。
特别提到了看“懂”，这里的懂，特指逻辑关系。
【 在 cxx 的大作中提到: 】
: 如果中文写的让不懂中文的人看懂就是好的中文了？
: 试着写个让街道的大妈看懂的quick sort.
: 【 在 pennyliang (好好学习，天天向上，学习刘翔好榜样) 的大作中提到: 】
cxx (no nickname) 于Thu Sep 30 11:32:06 2004)
提到：
那么换个说法，能让外行看懂的数学论文就是好的数学论文？
一种语言，首先是为了其使用者的交流，至于不懂这语言的人，不在考虑之列。
【 在 pennyliang (好好学习，天天向上，学习刘翔好榜样) 的大作中提到: 】
: 没有这个意思啊，我的意思是，不懂计算机的人是那些懂得英语的人，而且受过良..
: 育的非英语专业的人。街道大妈当然不算在内了。
: 特别提到了看“懂”，这里的懂，特指逻辑关系。
: 【 在 cxx 的大作中提到: 】
pennyliang (好好学习，天天向上，学习刘翔好榜样) 于Thu Sep 30 11:32:08 2004)
提到：
昨天，我强迫女友看我写的交友游戏的代码，让她提提意见，谁知道她死活不肯看。我
就是希望我写的代码简洁的如同小说那样。整个代码没有复杂的算法，只有业务和逻辑关
系。
【 在 innersmile 的大作中提到: 】
: 对真正要写代码的人来说,也许“代码就是最好的文档”,
: 但是要让不写程序的人来说,代码对他们来说没有意义,
: 他们看不懂也不想去看或者说没有必要去看, 他们有兴趣
: 可以去看文档. 而且他们对文档的可读性要求会很高,
: 这时候像一些继承关系, UML图之类的可能显得更加清楚,
: 不懂程序的人但是逻辑分析强的人对着图表跟他稍微解释
: 一下就会有个一目了然的效果.
:
: 【 在 pennyliang 的大作中提到: 】
Roach (chen3feng) 于Thu Sep 30 12:08:12 2004)
提到：
开玩笑呢，当真了?
【 在 pennyliang (好好学习，天天向上，学习刘翔好榜样) 的大作中提到: 】
: 是啊，那要很高的境界。
: 代码关键在于逻辑关系，每个人讲话做事都具有很强的逻辑关系，先做什么后做什么
: ，什么更好等等，所以不懂计算机的人的逻辑能力常常足够高明，完全可以接受代码所体
: 现的逻辑。
: 多年前的机器语言，到汇编，到C,到面向对象，语言变得越来越和现实世界紧密联系
: 而脱离了机器的复杂性，例如HTML语言很难看到什么文件操作，内存分配。。。
: 以前写程序不注意临时变量，函数，类的命名，代码可读性很差，有时候就是在命名
: 的时候可以思考很多，如果一个类很难命名也许这个类作的事情太多了，那么就应该分解
: 。
: 如果一个变量名可以讲述太代表的意义，一个函数名都可以体现自己的含义，那么实现这
: 些理想还是有可能的。
:
:
: 【 在 Roach 的大作中提到: 】
innersmile (innersmile) 于Thu Sep 30 12:17:16 2004)
提到：
【 在 pennyliang 的大作中提到: 】
: 昨天，我强迫女友看我写的交友游戏的代码，让她提提意见，谁知道她死活不肯看..
: 就是希望我写的代码简洁的如同小说那样。整个代码没有复杂的算法，只有业务和逻..
: 系。
晕倒, 你为什么一定要让她看代码,看一些设计和实现的文档不就可以吗?
: 【 在 innersmile 的大作中提到: 】
pennyliang (好好学习，天天向上，学习刘翔好榜样) 于Thu Sep 30 12:27:40 2004)
提到：
老板要求agile的开发方式，无文档，或者轻量级的文档[不可缺少的文档才写，例如
协议文档]。所以在代码的可读性上要求特别高，我这点代码反复改了很多次了。
【 在 innersmile 的大作中提到: 】
:
: 【 在 pennyliang 的大作中提到: 】
: 晕倒, 你为什么一定要让她看代码,看一些设计和实现的文档不就可以吗?
:
clgodest (【EE2K】菜菜) 于Thu Sep 30 15:07:16 2004)
提到：
如果中文写的让不懂中文的人看懂拿就真的是好中文了。
polarlight (light) 于Thu Sep 30 17:08:17 2004)
提到：
【 在 pennyliang 的大作中提到: 】希望吧
: 这段时间渐渐体会了老板说的话“代码就是最好的文档”，如果写出的代码象是..
: 故事，而且娓娓道来，那么这个代码我想一定是好代码。
HelloNJU (和南大打个招呼) 于Thu Sep 30 17:18:27 2004)
提到：
小程序可以，大的程序可能吗？
简直是幼稚。
南大计算机系的教授就是喜欢纸上谈兵，其实什么都不会，让他写点好代码试试？
cnzeng (好好写论文（这次是真的了）) 于Thu Sep 30 20:34:44 2004)
提到：
COBOL idiosyncracies
One of the design goals was to make the language as English-like as possible.
As a consequence the COBOL reserved word list is quite extensive and contains
hundreds of entries.
COBOL uses structural concepts normally associated with English prose such as
section, paragraph, sentence and so on. As a result COBOL programs tend to be
verbose.
Some implementations require the program text to adhere to certain, archaic, f
ormatting restrictions.
大家看看COBOL的设计思想，应该说是古老的程序设计，最大的目标就是像自然语言一样．
其实，在结构化的程序设计下，程序设计语言无非是顺序，条件，循环，模块，这些一般
的人也能懂．
只是到后来，特别是目前出现大量的东西，什么OO,设计模式这样东西，外行的一下子难以
理解．当然，这里不是说，现代的程序设计思想没有结构化设计好．
earlybird (天涯共CS~~在七楼看夜色) 于Thu Sep 30 21:55:16 2004)
提到：
怎么又扯到南大计算机系了？楼主说的老板又不是南大计算机的
而且你犯了一个严重的逻辑错误，“不懂计算机的人看得懂的代码是好的代码”，并不是
说“不懂计算机的人看不懂的代码就不是好代码”，连这都拎不清还学计算机？
【 在 HelloNJU 的大作中提到: 】
: 小程序可以，大的程序可能吗？
: 简直是幼稚。
: 南大计算机系的教授就是喜欢纸上谈兵，其实什么都不会，让他写点好代码试试？
Graph (%%%%%##) 于Thu Sep 30 23:48:44 2004)
提到：
应该是懂点编程语言甚至懂这种语言的人能看懂
就是不要写的完成同样功能但是高手都要读半天，呵呵，这意思吗
【 在 pennyliang 的大作中提到: 】
: 这段时间渐渐体会了老板说的话“代码就是最好的文档”，如果写出的代码象是..
: 故事，而且娓娓道来，那么这个代码我想一定是好代码。
chanxl009 (【冰城】骑士) 于Sat Oct 2 18:40:25 2004)
提到：
加注释就行了，一点不懂得人，再简单的能看懂才怪呢
【 在 pennyliang 的大作中提到: 】
: 这段时间渐渐体会了老板说的话“代码就是最好的文档”，如果写出的代码象是..
: 故事，而且娓娓道来，那么这个代码我想一定是好代码。
[返回] 计算机科学论坛 →
计算机技术与应用 → 『 C/C++编程思想 』 → 代码就是最好的文档[转自百合的精华贴]
(订阅本版)
2005/3/11 21:38:00
新浪微博
代码就是最好的文档[转自百合的精华贴]
