关于软件设计文档编写 如何编写软件需求文档

在学写文档初期,我总想去套一些国标的文档模板,套了半天,经常发现写出来的文档,连我自己都没有看懂,因此,也总结出来一条基本道理:生搬硬套某些文档模板,机械式的对文档模板进行填表的操作并不能够得到系统所真正需要的设计文档。

编写设计文档会起到两个作用:

一,在编写设计文档的过程中对系统进行一个全面思考的过程,由于设计文档也由需求分析,系统设计,详细设计这样逐层深入的设计的过程,因此这有助于系统设计者站在各个不同角度来思考系统,十分有助于全面深入整理整套系统以及发现一些潜在问题,这是系统开发的一个十分重要的过程。

二,我们都知道,现在在企业里开发软件,一般都不会是一个人从头到尾进行开发,多数系统都是有一个团队进行设计开发,这个时候,设计文档就起到了一个十分重要的信息传递沟通的作用,而且在系统开发完成,交付使用后,后期也会有很多的维护工作,这个时候,文档就更显其作用了。

基于以上两个作用,我觉得编写文档要了解以下几点:

一,我们了解我们所要写的是什么文档,它的作用是什么,它应该包含的内容都有哪一些,这是写文档的基本前提。

二,编写文档一定不能是应付式的,一定要认真的思考,否则,你就失去这个良好的思考过程。

三,文档是为了表达信息,不是为了符合某种标准,所以,不要过于迁强去适应某种标准,但是,如果既能符种一些通用的文档规范,又能将信息表达清楚,那当然更好了。

三,文档的格式应该清晰明了,要让人一看目录大纲,就对文档整体分布了然于胸,

四,内容表达重在清楚,关键是要将设计思想表达出来,不在写太多冗余性的文字,尽可能配上一些图形来表达思想,因为,人对图像信息的吸收比文字来得快。

所谓磨刀不误砍柴工,写文档就是一个磨刀的过程,刀是砍柴的工具,同样,设计文档也是软件系统设计的一个基本工具,古人不是也有过精辟的结论嘛:“工欲善其事,必先利于器”,我们在系统开发前期,将这些工作完善了,那么系统开发起来就会更加顺利,项目的成功率也就更高,后期维护也会更轻松,因此,设计文档同时也是一种功能当代,利在千秋的工作,一定要注意做好。

关于软件设计文档编写 如何编写软件需求文档

  

爱华网本文地址 » http://www.aihuau.com/a/25101014/237727.html

更多阅读

怎样设计幻灯片模板 自己如何制作ppt模板

PPT在日常生活工作的方便性相信很多用户都体验到了,而且制作过程也简单易学,网上各种大量的PPT也层出不穷,但为了避免在工作中使用幻灯片模板遇到“撞衫”的情况,有没有想过自己设计一套属于自己的PPT模板呢?又如何设计幻灯片模板?我们一

如何才能把软件需求分析做好? 软件需求分析

如何才能把软件需求分析做好?又到新年了,日历又要从2011年翻到2012年了,这使我有太多的感慨,进而勾起了对太大往事的回忆。过去的10年,毫无疑问是中国软件业发展最快的10年。当我们刚刚毕业的时候,还在使用VB、PB开发一些简单的数据库应用

转载 关于理想,关于致青春文自豆瓣 理想国九州出版社豆瓣

原文地址:关于理想,关于致青春文自豆瓣作者:长沙理工大学文法学工前两天看到一个句子,“遥不可及的并非是十年之后,而是今天之前”,觉得甚好。句子的美丽,不在于它说的有多文学、或者艺术,而仅在于,它说明了你内心里所想的一个理,你觉得是它了

关于问卷设计 调查问卷设计

西南大学黄希庭教授是一位治学严谨的学者,更是一位受人尊敬的学界前辈,现任西南大学资深教授,心理学博士生导师,我一直都很崇拜黄老先生,几年前有幸听过他的“关于问卷设计”的讲座,真的是受益匪浅。现将当年对讲座的记录提纲发在这里,希望

声明:《关于软件设计文档编写 如何编写软件需求文档》为网友回忆积累在胸口分享!如侵犯到您的合法权益请联系我们删除