请教关于软件开发详细设计文档的事情 [发表于 2004/7/14] 状态 开放帖 浏览量 2209 |
|
我公司的软件开发经理总是对项目经理说:教科书上的详细设计文档是不现实的,不是奖金不多我们不愿写,也不是时间不够我们来不及写,如果硬是要我们写出详细设计文档,那同时代码也写好了。 我不懂程序开发的,所以想请教有经验的朋友:详细设计文档撰写出来所需要的精力,真的可以同时把代码也写好了吗?那么国外发包过来的程序单子既然有那么详细的说明,老外为什么不自己写好代码算了?
|
>>> 由论坛统一发布的广告:
|
|
楼主
weslley
职务 无
军衔 三等兵
来自 上海
发帖 0篇
注册 2007/12/8
PM币 0
经验
|
|
Re:请教关于软件开发详细设计文档的事情
[回复于 2004/7/14]
|
这是写程序的习惯和规范问题,确实很多公司不要求写详细设计文档资料, 在编码之前先写设计文档有很多好处,一个是编码的进度可以加快,如果详细设计作的好,编码是很轻松的事情了,磨刀不误砍材工.二是可读性比较好,三是编码的逻辑非常清晰了,不容易出现逻辑错误.特别是一些逻辑很复杂的代码,是一定要有详细设计的,即使有流程图也比直接去写程序好些. 所以我认为初学者一定要养成良好的习惯. 抛砖引玉-----
|
|
|
1楼
ceszh2000
职务 无
军衔 中士
来自 不告诉你 :)
发帖 95篇
注册 2004/5/28
PM币 238
经验
|
|
Re:请教关于软件开发详细设计文档的事情
[回复于 2004/7/14]
|
虽然我自己也从来没有写过详细设计文档,也从来没看到过真正的详细设计文档,但按照我个人的理解,的确在国内做所谓的详细设计可行性不高。原因有三: 1、软件开发流程分工不明确; 2、缺乏对整个项目做法的规范,特别是细致的规范控制; 3、国内实际的项目环境,如需求获取过程的不规范、进度要求的不科学、费用估计的主观性,等等。 正是由于上述原因,导致教科书式的详细设计可行性不高,而且单独来看,其维护成本太高。
|
|
|
2楼
stephenwang2
职务 无
军衔 二等兵
来自 不告诉你 :)
发帖 59篇
注册 2003/3/1
PM币 193
经验
|
|
Re:请教关于软件开发详细设计文档的事情
[回复于 2004/7/14]
|
我是做系统的,在学校时做过小软件,毕业后就转行了。但是,从我接受的培训和我们项目组实际运行情况,谈一些感想。 1 软件文档设计30%和70%的关系。中国软件人员一般不习惯写文档,喜欢拿来就干,这就往往造成30%的时间就写完代码,剩下70%的时间来调试和找Bug。而外国(印度和美国)人往往70%的时间用来写文档,30%的时间就能够调试好(或者更少的时间)。 2 做设计任务书时,往往对软件安排的时间进度不合理,对写文档预留时间不足,导致文档质量很差,或者说就是为了完成任务而写文档。 3 “初学者一定要养成良好的习惯”,很有道理。
|
|
|
3楼
syec
职务 无
军衔 三等兵
来自 不告诉你 :)
发帖 16篇
注册 2004/7/1
PM币 126
经验
|
|
Re:请教关于软件开发详细设计文档的事情
[回复于 2004/7/15]
|
写不写设计是根据你的目标来定的,有句话叫什么来着“有多少钱办多少事”,对做项目来说一样道理。没钱没时间,当然设计简单扼要。但预算充足的正规项目不写详细设计那是偷懒,你们公司的软件开发经理明显在牺牲项目和公司利益袒护下属,因为对一般程序员来说很讨厌写设计。 建议你们公司建立产品开发和项目实施的methodology,从制度上断了软件开发经理的后路。
|
|
|
4楼
pear_bai
职务 无
军衔 二等兵
来自 不告诉你 :)
发帖 21篇
注册 2004/5/14
PM币 131
经验
|
|
Re:请教关于软件开发详细设计文档的事情
[回复于 2004/7/15]
|
谢谢各位的回贴。 我的提问中,强调的是“详细设计文档”,在它之前还有一个“概要设计文档”,概要设计我们是能够做到的,基本上包括了每一个不可细分的模块的业务流程和接口描述。在此基础上,还有没有必要继续做进一步的设计,详细到函数定义级别?请大家继续提出高见,谢谢!
|
|
|
5楼
weslley
职务 无
军衔 三等兵
来自 上海
发帖 0篇
注册 2007/12/8
PM币 0
经验
|
|
Re:请教关于软件开发详细设计文档的事情
[回复于 2004/7/15]
|
详细设计的定义:子程序输入/输出/程序逻辑/出错处理/数据 详细设计的好处:对编程工作的指导,消除二义性,工作角色分开,考核依据 详细设计的代价:工作量、额外的一致性维护成本、如果团队/项目规模较小,意义不大 没有必要/不必要的简单判定,根据项目规模,工期,人员配置情况,重要程度 以及公司内部对这方面的认识等因素决定吧
|
|
|
6楼
stephenwang2
职务 无
军衔 二等兵
来自 不告诉你 :)
发帖 59篇
注册 2003/3/1
PM币 193
经验
|
|
Re:请教关于软件开发详细设计文档的事情
[回复于 2004/7/15]
|
同意楼上!
|
|
|
7楼
cncaigs
职务 无
军衔 一等兵
来自 广东
发帖 904篇
注册 2004/1/11
PM币 2225
经验
|
|