关于软件设计文档编写
做了这么多年的软件开发工作，从一个纯碎的软件编码人员，到现在的挂上一个项目经理的名头，担负起一些系统设计及项目管理方面的工作，我一直觉得软件设计文档这方面是我的最大软肋，在这方面也花了好些精力去探索它，总希望能够找到一种适合自己的软件设计文档编写方法，但一直都没有找到，也曾尝试着去套一些国标之类的文档模板，但总是感觉设计思想是有，但写起文档来却力不从心，没办法将系统及子模块设计思想真实的反映到文档上，也经常是事后修修补补还是不尽如人意，以前总听人说，如果你能够将你所要表达的事物清楚的传递给别人，那就说明你对这个事物有真正足够的了解了，看来我的真正的软肋不是在设计文档，而是我的系统设计能够还十分欠缺，以致于我没办法将自己的设计思想用文字表达清楚吧。
当然，在这些探索过程中，也不是完全没有收获，基本上，还是搞清了一些文档编写的基本原则，真着今日在家中偷闲，将这点积累总结一下，省得明天又给忘了，呵。
在学写文档初期，我总想去套一些国标的文档模板，套了半天，经常发现写出来的文档，连我自己都没有看懂，因此，也总结出来一条基本道理：生搬硬套某些文档模板，机械式的对文档模板进行填表的操作并不能够得到系统所真正需要的设计文档。
编写设计文档会起到两个作用：
一，在编写设计文档的过程中对系统进行一个全面思考的过程，由于设计文档也由需求分析，系统设计，详细设计这样逐层深入的设计的过程，因此这有助于系统设计者站在各个不同角度来思考系统，十分有助于全面深入整理整套系统以及发现一些潜在问题，这是系统开发的一个十分重要的过程。
二，我们都知道，现在在企业里开发软件，一般都不会是一个人从头到尾进行开发，多数系统都是有一个团队进行设计开发，这个时候，设计文档就起到了一个十分重要的信息传递沟通的作用，而且在系统开发完成，交付使用后，后期也会有很多的维护工作，这个时候，文档就更显其作用了。
基于以上两个作用，我觉得编写文档要了解以下几点：
一，我们了解我们所要写的是什么文档，它的作用是什么，它应该包含的内容都有哪一些，这是写文档的基本前提。
二，编写文档一定不能是应付式的，一定要认真的思考，否则，你就失去这个良好的思考过程。
三，文档是为了表达信息，不是为了符合某种标准，所以，不要过于迁强去适应某种标准，但是，如果既能符种一些通用的文档规范，又能将信息表达清楚，那当然更好了。
三，文档的格式应该清晰明了，要让人一看目录大纲，就对文档整体分布了然于胸，
四，内容表达重在清楚，关键是要将设计思想表达出来，不在写太多冗余性的文字，尽可能配上一些图形来表达思想，因为，人对图像信息的吸收比文字来得快。
所谓磨刀不误砍柴工，写文档就是一个磨刀的过程，刀是砍柴的工具，同样，设计文档也是软件系统设计的一个基本工具，古人不是也有过精辟的结论嘛：“工欲善其事，必先利于器”，我们在系统开发前期，将这些工作完善了，那么系统开发起来就会更加顺利，项目的成功率也就更高，后期维护也会更轻松，因此，设计文档同时也是一种功能当代，利在千秋的工作，一定要注意做好。
关于软件设计文档编写相关推荐
- 软件设计文档如何编写，设计文档内容都包括什么
我们经常听到这样的话: "设计文档没有用,是用来糊弄客户和管理层的文档": "用来写设计文档的时间,项目开发早就做完了": "项目紧张,没有时间做设计 ...
- 局域网聊天软件 设计文档怎么写？
局域网聊天软件 设计文档怎么写?这种针对数据库记录的 局域网聊天软件 窃取,被一些攻击者称为拖库,于是有了一个自然而谐音的戏称脱裤.只是攻击者日趋不厚道,从前只是偷了人家的裤子,现在还要晾在大街上,并 ...
- SCADE Display（OpenGL）软件设计文档生成工具的设计考虑
SCADE Display(OpenGL)软件设计文档生成工具的设计考虑 2018年6月 1 引言 本文档描述在SCADE Display软件设计文档生成工具(以下简称为SDYSDDGEN)的设计过程 ...
- 一般性网络错误 请检查网络文档_如何编写好的软件设计文档
原文链接 作为一名软件工程师,我花了很多时间阅读和编写设计文档.在研究了数百篇这样的文档之后,我发现好的文档与项目成功之间有很强的关联性. 在本文中,我尝试去说明如何才能编写好的设计文档. 本文分为4 ...
- 如何编写一个好的软件设计文档
作为一名软件工程师,我花了很多时间阅读和编写设计文档.在完成了数百篇这些文档之后,我亲眼目睹了优秀设计文档与项目最终成功之间的强烈关联. 本文试图描述使设计文档变得更好的原因. 本文分为4个部分: 为 ...
- 如何写出一份优秀的软件设计文档
作为一名软件工程师,我花了很多时间阅读和编写设计文档.在完成了数百篇这些文档之后,我亲眼目睹了优秀设计文档与项目最终成功之间的强烈关联. 本文试图描述什么使设计文档变得更好. 本文分为4个部分: · ...
- 如何才能写出好的软件设计文档？
作为一名软件工程师,我花了很多时间在阅读和撰写设计文档上.在磨砺了数百篇文档之后,我发现,优秀的设计文档与项目的成功之间有着密切的联系. 这篇文章将介绍怎样才能写出一份优秀的设计文档. 为什么要写设计 ...
- 【译】如何写出一份优秀的软件设计文档
作为一名软件工程师,我花了很多时间阅读和编写设计文档.在完成了数百篇这些文档之后,我亲眼目睹了优秀设计文档与项目最终成功之间的强烈关联. 本文试图描述什么使设计文档变得更好. 本文分为4个部分: 为什 ...
- 如何从数据库中筛选出达成指定里程碑节点的项目_【译】如何写出一份优秀的软件设计文档...
作为一名软件工程师,我花了很多时间阅读和编写设计文档.在完成了数百篇这些文档之后,我亲眼目睹了优秀设计文档与项目最终成功之间的强烈关联. 本文试图描述什么使设计文档变得更好. 本文分为4个部分: 为什 ...
- 软件设计文档国家标准
转自:http://blog.sina.com.cn/s/blog_62bb1dbe0100qlj9.html 操作手册(GB8567--88) 1引言 1.1编写目的 说明编写这份操作手册的目的,指 ...
最新文章
- WCF4.0进阶系列--第四章 保护企业内部的WCF服务（转）
- sql根据某个字段拼接另外字段
- docker安装启动nginx详细步骤
- rancher k8s docker 关系_【环境搭建】Ubuntu20.04通过rke部署K8S
- qimage加载bmp图片_批量修改图片大小，我发现了最简单的方法！
- 关于域名解析到服务器的问题
- python深入_Python深入（上）
- 怎么隐藏Windows11开始菜单中的推荐面板
- Goroutine（协程）为何能处理大并发？
- 剖析Android Traceview效率工具及两种建SDcard方式
- [转]输入框对齐问题
- 15个很有用的 HTML5 基础教程和速查手册
- 紫薇在线排盘php源码,灵匣网紫微斗数在线排盘系统
- mysql error1682_mysql5.7报错 1546、1577和1682问题分析
- eHIDS 一款基于eBPF的HIDS开源工具
- Shell获取配置文件中一个字段的值
- 七.getchar 和 scanf
- Linux（Ubuntu16.04）自学笔记，资源整理
- JavaScript String 对象参考手册 italics() 方法
- qt编写网易云界面（10）----排行榜模块