如何写应用软件设计文档

    自IT系统诞生至今,如何沟通需求的方法讲了不少,如何设计软件的方法讲了不少,如何开发讲了不少,现在也开始逐步的讲测试了,但是唯独没有人系统的讲如何写设计文档,尤其是指派不擅长写文档的开发人员完成文档时,这项工作就成了一项让他们“头疼”的活。

    谁都知道文档重要,说起别人的文档头头是道,等到落笔的时候又不知道从哪里下手,在哪里收笔,而且经常出现的文档问题如:

  • 不伦不类型:
  • 概要设计写的像系统功能需求
  • 概要设计介入了详细设计的范畴
  •  概要设计像是程序速查手册
  • 态度不良型:
  • 觉得没什么可写的,都是大家知道的事
  •  纯粹就是应付检查
  •  …

        上述几点都是在设计文档中经常出现的毛病,还有其他毛病,比如逻辑性不严密,缺乏层次性等等,就不一一列举了。

诚然,写设计文档的方法和手段很多,尽管软件开发技术多变,软件需求多变,但是我们应当尽量的固化设计文档的结构、写法和思考路线。如同音乐多变化,但是表达音乐的五线谱是固定的。

        

        其实造成这种现状的原因非常多,部分原因列举如下:

  • 团队的管理问题;
  • 领导层重视程度问题;
  • 不会写设计文档的问题。

扫描二维码关注公众号,回复: 4382656 查看本文章
        请到“ http://www.docin.com/p-248584591.html”中查阅,如何通过提高书写设计文档能力来改善设计文档使用效率和效果。

        请到“http://www.docin.com/p-248584592.html”中查阅,概要设计模板参考文档。

        请到“http://www.docin.com/p-248584593.html”中查阅,详细设计模板参考文档。


        希望这三篇文章对您的设计文档写作水平有所启示。


猜你喜欢

转载自blog.csdn.net/xmsea/article/details/6717117