标题: 关于下帖的所谓文档“规范”
weihello
LU幼天使
Rank: 2



UID 1227
精华 1
积分 29
帖子 53
活跃指数 0
LU金币 5406 个
LU金条 0 个
阅读权限 20
注册 2003-10-31
 
发表于 2003-11-14 09:50  资料  个人空间  短消息  加为好友 
对于一个程序员来说,这简直是扼杀创造力,简直是侮辱。

按几位的的看法,程序员要陷入浩如烟海的文档。而本行program则成了次要的问题。

为什么不多花点时间写测试,多花点时间在团队合作建设上?为什么让程序员成了一个次要的位置?

软件开发,程序员始终最为重要。

下面是potian大师的一些看法

QUOTE
大约早上6:00左右,在KeKe的Snip上看到
A product specification
A detailed user interface prototype
A realistic schedule
Explicit priorities
Active risk management
A quality assurance plan
Detailed activity lists
Software configuration management
Software architecture
An integration plan
显而易见,没有程序员什么事情。很想为他们(当然也包括我)抱不平。但是,的确coding在整个软件过程当中是最简单不过的事情了。
我不知道说什么才好,如果这样的Snip出现在McBreen的SnipSnap上,或者出现在1997年某一个程序员的主页上都会让我好理解一点。
我不知道说什么,但我实在想说太多。
我冲动得想告诉KeKe那些软件史上重要的作品:C、Unix、Emacs、LaTex、Linux、Apache都不是这样诞生的,我也想告诉KeKe我自己能够引以为自豪的微不足道的项目都是团队人性、协作的编码换来的,我想推荐KeKe去看《The Psychology of Compter Programming》、《Adaptive Software Development》、《The Pragmatic Programmer》、《XP Explained》、《Peopleware》,但最终我还是无语了。
前段时间,当一个大学的校长告诉我他要把自己大学的软件学院建成全国最大的软件蓝领生产基地时,我也无语了。
还记得托普的几万人软件航母计划吗?为什么会有争论,为什么还需争论?为什么竟然还有那么多程序员真的就去了?我们的软件企业?我们的程序员?我无语了。
我想说很多,就是不知道说什么.....





生活需要点糖

http://www.erproad.org
顶部
qinxj
技术专家
Rank: 14Rank: 14Rank: 14Rank: 14



UID 1117
精华 1
积分 166
帖子 328
活跃指数 0
LU金币 5406 个
LU金条 0 个
阅读权限 200
注册 2003-10-29
 
发表于 2003-11-14 10:00  资料  个人空间  短消息  加为好友  添加 qinxj 为MSN好友 通过MSN和 qinxj 交谈
的确不应该做一些毫无意义的文档,但是有些文档是必须存在。

如果一个软件缺乏必要的文档,不能说该软件是一个成功的软件!看看那一个lunix下的程式不是档案详尽呢?对于开源文化的代码来说,文档就更加重要了,否则怎么会被internet上的兄弟不断的优化优化再优化。

文档之所以存在的目的不外乎以下几个:
1、整理自己的思路
2、写给用户看
3、与其他程序员之间的交流





合久必分、分久必和!
顶部
无双
荣誉斑竹
Rank: 14Rank: 14Rank: 14Rank: 14
天才猪



UID 4
精华 84
积分 5863
帖子 11390
活跃指数 0
LU金币 4248 个
LU金条 0 个
阅读权限 200
注册 2003-9-16
来自 杭州
 
发表于 2003-11-14 10:01  资料  个人空间  主页 短消息  加为好友 
大软件中设计是70%

测试是20%

编码只是10%

开始的设计不好

后面修改的代价很大





不要问我结果 我只研究过程与思路
无双客栈
顶部
weihello
LU幼天使
Rank: 2



UID 1227
精华 1
积分 29
帖子 53
活跃指数 0
LU金币 5406 个
LU金条 0 个
阅读权限 20
注册 2003-10-31
 
发表于 2003-11-14 10:07  资料  个人空间  短消息  加为好友 
QUOTE(无双 @ 2003-11-14 10:01:01)
大软件中设计是70%

测试是20%

编码只是10%

开始的设计不好

后面修改的代价很大

程序员应该有点自己的想法,不该人云亦云。

说这句话的背景是什么?

上个世纪八十年代末九十年代初还很流行case呢,人们认为软件开发由程序员来做是不可能的呢。 于是要开发一个“业务开发平台”给专业人士开发。

而现实呢?现实是,程序员的位置越来越重要。case国际上也没有多少人在提了。





生活需要点糖

http://www.erproad.org
顶部
threehair
荣誉斑竹
Rank: 14Rank: 14Rank: 14Rank: 14


UID 27
精华 78
积分 3034
帖子 5716
活跃指数 0
LU金币 2093 个
LU金条 0 个
阅读权限 200
注册 2003-9-17
 
发表于 2003-11-14 10:25  资料  个人空间  短消息  加为好友 
我一直认为,人是任何活动中的最重要的因素。
但是任何东西都有两面性。过犹不及。对人、对文档都一样
在软件活动中也一样。但是成也萧和,败也萧和。软件活动中的人太多了,如果没有合适的规范怎么可以规范不同人的活动?只能是一盘散沙而已。如果文档规范过了,同样也不行。
只有合适的才是最好的。





╭⌒╮ ╭⌒╮╭⌒╮
╱◥███◣╭╭ ⌒╮
︱田︱田   田|
关门,上锁,钥匙已生锈。
世事静方见,人情淡始长!
顶部
weihello
LU幼天使
Rank: 2



UID 1227
精华 1
积分 29
帖子 53
活跃指数 0
LU金币 5406 个
LU金条 0 个
阅读权限 20
注册 2003-10-31
 
发表于 2003-11-14 14:26  资料  个人空间  短消息  加为好友 
QUOTE(threehair @ 2003-11-14 10:25:45)
我一直认为,人是任何活动中的最重要的因素。
但是任何东西都有两面性。过犹不及。对人、对文档都一样
在软件活动中也一样。但是成也萧和,败也萧和。软件活动中的人太多了,如果没有合适的规范怎么可以规范不同人的活动?只能是一盘散沙而已。如果文档规范过了,同样也不行。
只有合适的才是最好的。

规范重要,但人的需要更重要,程序员是人。男人,女人.......

规范不是写XXXX个文档,而在乎如何协作。 交流通过文档肯定会由种种问题,何不之间面对面的交流? 即使不能面对面的交流,那么,也应该以大家最容易最恰当的方式交流。至于程序员最熟悉的交流方式是什么,我也不说了。好的代码应该不需要XXXX个文档。


下面给个简单的例子,如果让你选择,你写文档嘛?
1----------------
CODE

public class PriceCaculator {
  public double caculate(Goods goods,double amount){
         .....
  }
}



2----------------
商品计算类:PriceCaculator,商品计算类用于计算商品的价格,caculate方法返回值值是商品价格。 goods是商品,amount是商品的数量.............





生活需要点糖

http://www.erproad.org
顶部
[广告] 记录自己的思想火花,留住每日的技术积累,尽在拥有属于自己独立域名的博客。
threehair
荣誉斑竹
Rank: 14Rank: 14Rank: 14Rank: 14


UID 27
精华 78
积分 3034
帖子 5716
活跃指数 0
LU金币 2093 个
LU金条 0 个
阅读权限 200
注册 2003-9-17
 
发表于 2003-11-14 14:38  资料  个人空间  短消息  加为好友 
但是铁打的营房,流水的兵。
作的人走了,后来接手的人怎么做?和谁交流?
有规范的文档可以帮助别人理解。
文档只是一个工具。是人在使用工具,而不是人在适应工具。
所以,如果没有必要,当然可以不必写文档。沙鸡何必用牛刀?合适才是最重要的。

不必拘泥于要不要写文档这个问题。换个思考方式,需要写文档吗?写了文档之后有帮助吗?如果答案是肯定的,那就写;相反,何必要做无用功,甚至得不偿失呢?

不要抗拒文档,也不必过分推崇文档这就是哦的意见。





╭⌒╮ ╭⌒╮╭⌒╮
╱◥███◣╭╭ ⌒╮
︱田︱田   田|
关门,上锁,钥匙已生锈。
世事静方见,人情淡始长!
顶部
[广告] 记录自己的思想火花,留住每日的技术积累,尽在拥有属于自己独立域名的博客。
无双
荣誉斑竹
Rank: 14Rank: 14Rank: 14Rank: 14
天才猪



UID 4
精华 84
积分 5863
帖子 11390
活跃指数 0
LU金币 4248 个
LU金条 0 个
阅读权限 200
注册 2003-9-16
来自 杭州
 
发表于 2003-11-14 15:29  资料  个人空间  主页 短消息  加为好友 
有些交流 是需要被文档记下来的

并不是说当时说过就过了

另外

设计是70%也并非780年代的产物
现在一样存在

当有机会做大项目时就知道了

设计好了 接口好了
剩下的只是找人填空了

如果设计不好 接口不定 软件框架不定
那再什么写也是很乱 这对大软件来说是不可能的





不要问我结果 我只研究过程与思路
无双客栈
顶部
[广告] 记录自己的思想火花,留住每日的技术积累,尽在拥有属于自己独立域名的博客。
qinxj
技术专家
Rank: 14Rank: 14Rank: 14Rank: 14



UID 1117
精华 1
积分 166
帖子 328
活跃指数 0
LU金币 5406 个
LU金条 0 个
阅读权限 200
注册 2003-10-29
 
发表于 2003-11-14 15:42  资料  个人空间  短消息  加为好友  添加 qinxj 为MSN好友 通过MSN和 qinxj 交谈
applauding^_^happy.gif





合久必分、分久必和!
顶部
[广告] 记录自己的思想火花,留住每日的技术积累,尽在拥有属于自己独立域名的博客。
weihello
LU幼天使
Rank: 2



UID 1227
精华 1
积分 29
帖子 53
活跃指数 0
LU金币 5406 个
LU金条 0 个
阅读权限 20
注册 2003-10-31
 
发表于 2003-11-17 09:32  资料  个人空间  短消息  加为好友 
QUOTE(threehair @ 2003-11-14 14:38:09)
但是铁打的营房,流水的兵。
作的人走了,后来接手的人怎么做?和谁交流?
有规范的文档可以帮助别人理解。
文档只是一个工具。是人在使用工具,而不是人在适应工具。
所以,如果没有必要,当然可以不必写文档。沙鸡何必用牛刀?合适才是最重要的。

不必拘泥于要不要写文档这个问题。换个思考方式,需要写文档吗?写了文档之后有帮助吗?如果答案是肯定的,那就写;相反,何必要做无用功,甚至得不偿失呢?

不要抗拒文档,也不必过分推崇文档这就是哦的意见。

无所谓抗拒不抗拒的,问题在于需要所谓 分析--概要设计--详细设计 如此事无巨细的文档嘛?

文档不是不需要,而是不要企图将所有你的代码和设计的目的都依赖之。

IMO,文档在项目中的位置,应该简洁赅要,且不应该成为指导,交流的主要工具。也不不应该成为工作中的一个重要组成部分。





生活需要点糖

http://www.erproad.org
顶部
weihello
LU幼天使
Rank: 2



UID 1227
精华 1
积分 29
帖子 53
活跃指数 0
LU金币 5406 个
LU金条 0 个
阅读权限 20
注册 2003-10-31
 
发表于 2003-11-17 09:40  资料  个人空间  短消息  加为好友 
QUOTE(无双 @ 2003-11-14 15:29:13)
有些交流 是需要被文档记下来的

并不是说当时说过就过了

另外

设计是70%也并非780年代的产物
现在一样存在

当有机会做大项目时就知道了

设计好了 接口好了
剩下的只是找人填空了

如果设计不好 接口不定 软件框架不定
那再什么写也是很乱 这对大软件来说是不可能的

////////////////////
设计好了 接口好了
剩下的只是找人填空了
///////////////////////

又是一个空想主义家,如果你能达到这种境界,那么,你应该去获得图灵奖了。能不能告诉我世界上有这样的做系统嘛? 有的话,告诉大家。 grin.gif
///
当有机会做大项目时就知道了
///

我已经说过了,我想中国并非只有 无双 的单位在做所为的大项目吧?我拷贝过来,让你再看一次。


不知道要多大? 一个ERP产品不知道算不算大?

另外一个华北地区系统,用户遍布几个省两个直辖市,使用者至少数千人。算不算大系统?

上述两个系统,我都参与过开发和维护。





生活需要点糖

http://www.erproad.org
顶部
threehair
荣誉斑竹
Rank: 14Rank: 14Rank: 14Rank: 14


UID 27
精华 78
积分 3034
帖子 5716
活跃指数 0
LU金币 2093 个
LU金条 0 个
阅读权限 200
注册 2003-9-17
 
发表于 2003-11-18 12:31  资料  个人空间  短消息  加为好友 
QUOTE(weihello @ 2003-11-17 09:32:23)
无所谓抗拒不抗拒的,问题在于需要所谓 分析--概要设计--详细设计 如此事无巨细的文档嘛?

   文档不是不需要,而是不要企图将所有你的代码和设计的目的都依赖之。

   IMO,文档在项目中的位置,应该简洁赅要,且不应该成为指导,交流的主要工具。也不不应该成为工作中的一个重要组成部分。

哦感觉文档有些类似写文章的提纲。但是写文章是一个人的事情。所以可写可不写。例如哦就从来不喜欢写提纲。但是并不意味哦对整个文章没有提纲,只是没有写出来而已。至于软件开发过程中的文档,就有这个作用。文档是无需太多。当然能省还是要省,直接影响软件生命周期的文档不能省,有多少公司文档已大车,实际内容不多。但是必要的文档不但不能少而且要精。 软件开发毕竟是一项集体的创作。没有规矩何以成方圆?大多数的程序员都是认为文档限制了程序员的创造性和发挥.不知大家有没有想过:程序是按照一定要求制造出来的产品,而产品是要给客户用的,所以适用性是非常重要的。另外,产品是不可能有一个人做的。文档在这里很大一部分起着承上启下,相互沟通的作用。(比如说,现在的IT企业换人的速度很快。你做了一个项目,如果你走了,那接手的人怎么了解?当然需要文档。而且好记性不如烂笔头。时间久了,可能有些东西你自己都忘记了。这时候如果又文档备案,当然容易记起了。)





╭⌒╮ ╭⌒╮╭⌒╮
╱◥███◣╭╭ ⌒╮
︱田︱田   田|
关门,上锁,钥匙已生锈。
世事静方见,人情淡始长!
顶部
 



当前时区 GMT+8, 现在时间是 2008-10-7 19:02
乐悠LoveUnix论坛-京ICP备05005823号

Thanks to Discuz!  © 2001-2007    Power by LoveUnix.net
Processed in 0.057276 second(s), 6 queries , Gzip enabled

清除 Cookies - 联系我们 - 乐悠LoveUnix - Archiver