请教关于软件开发详细设计文档的事情 [发表于 2004/7/14] 状态 开放帖 浏览量 2215 |
|
|
|
我公司的软件开发经理总是对项目经理说：教科书上的详细设计文档是不现实的，不是奖金不多我们不愿写，也不是时间不够我们来不及写，如果硬是要我们写出详细设计文档，那同时代码也写好了。 我不懂程序开发的，所以想请教有经验的朋友：详细设计文档撰写出来所需要的精力，真的可以同时把代码也写好了吗？那么国外发包过来的程序单子既然有那么详细的说明，老外为什么不自己写好代码算了？
|
>>> 由论坛统一发布的广告：
|
|
楼主
 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
经验
|
|
项目型组织
项目管理
工程项目
科技项目
资格认证
职业休闲
