首页 新闻 搜索 专区 学院

详细设计说明书项目完成之前写和完成之后的有什么不同?

0
悬赏园豆:100 [待解决问题]

我现在是在写已经完成的项目的详细设计说明书,写了好几遍了都写的不好,这本来是在项目开发之前应该完成的,而我的疑问是,这之前和之后写出来的文档是否都是一样的?不一样的话,那从设计的角度编写又有什么样的差异?这样的差异会导致什么样后果呢?

在实际的项目开发中,详细说明书是开发之前写的多还是之后完善了在编写的多??

Kaviry Tang的主页 Kaviry Tang | 初学一级 | 园豆:100
提问于:2010-12-14 10:46
< >
分享
所有回答(3)
0

详细设计必须编码前写,否则一旦人员离职,项目接手的人没有设计书怎么保证跟进项目进度?而且在设计通过时可以互相检查各自的设计思路是否正确?等等,好处多多不用细说。当然设计书要一个有经验的老鸟写才行,否则肯定设计不完善。

不可避免,编码后遇到一些考虑不足的地方要修改设计书。但是任何东西总会存在bug。修改不可避免。如果放到编码后再写设计书,那么写设计的就变成写报告了。不能称之为设计书,而是代码注释,呵呵。

现实中可能工期等等诸多因素导致只能编码后添加设计书,此时就以挣钱为首要目标,客户不知道就行<别说我没职业道德>

茂茂 | 园豆:2887 (老鸟四级) | 2010-12-14 11:18
而我作为新手来写设计文档,怎么样才能使写出的设计文档更接近真正的设计文档而不是一种代码报告呢?
支持(0) 反对(0) Kaviry Tang | 园豆:100 (初学一级) | 2010-12-15 09:29
新手只能通过不断的练习才行。否则,软件架构师们都不需要工作经验了。设计部分必须要的不能使新手,必须要有积累。并且没有两三年的工作经历也不能体会设计的重要性
支持(0) 反对(0) 茂茂 | 园豆:2887 (老鸟四级) | 2010-12-17 12:09
0

对于已经完成的项目,去补详细设计说明书的话,可以让每个开发人员把自己负责的模块的详细设计整理好,然后你根据每个模块的详细设计说明书,写出整个项目的详细设计。这样会好一点。

yearN | 园豆:551 (小虾三级) | 2010-12-14 13:20
0

1、首先,设计文档在开发之前写和开发之后写会有较大的区别,在于该软件系统的规模、复杂度等等的影响。

2、一般来说,设计文档在开发前写,那么该文档记录的是设计的思想,架构等内容,与实际代码实现后有较大区别。而设计文档在开发后写,那么该文档记录的是代码实现的内容。

3、这两个的差异其实没有什么大的影响。首先,设计文档本身,就是记录软件开发的过程,设计思想等内容。文档的作用,就是作为软件系统开发的附属产品而遗留下来的。

4、在现有的小型软件系统情况下,文档只是用来对软件系统本身进行记录,没有大的作用,其实程序员更多的是看需求文档和代码,因为在现在的情况下,没有那么大的划分职责。

5、在开发之前写设计文档,记录的是软件系统设计的思路,并不代表能够全部的实现软件系统层次的内容及代码所需要的内容。因为人无完人,软件系统也一样,前期的设计是不够的。在软件系统开发过程中,是需要对设计文档进行补充的,因为需求也会变化。。。

 

最后,欢迎你加入博客园分享自己的经验。。。。。。

 

Austin

Austin Liu   刘朝辉

Project Manager and Software Design

lzhdim | 园豆:659 (小虾三级) | 2010-12-16 10:24
清除回答草稿
   您需要登录以后才能回答,未注册用户请先注册