本页使用了标题或全文手工转换

软件文档

维基百科,自由的百科全书
跳转至: 导航搜索
软件开发
软件开发步骤
需求分析 | 软件架构 | 软件设计 | 软件编程 | 软件测试 | 软件部署 | 軟體維護
软件开发模式
敏捷开发 | 無塵室 | 迭代式开发 | RAD | 统一过程 | 螺旋模型 | 瀑布模型 | 极限编程 | Scrum
软件开发辅助领域
配置管理 | 文档编写 | 质量管理 | 项目管理 | 使用者經驗設計
软件开发工具
编译器 | 除错器 | 性能分析 | GUI设计 | 集成开发环境

软件文档或者源代码文档是指与软件系统及其软件工程过程有关联的文本实体。文档的类型包括软件需求文档,设计文档,测试文档,用户手册等。其中的需求文档,设计文档和测试文档一般是在软件开发过程中由开发者写就的,而用户手册等非过程类文档是由专门的非技术类写作人员写就的。

早期的软件文档主要指的是用户手册,根据Barker[1]的定义,文档是用来对软件系统界面元素的设计、规划和实现过程的记录,以此来增强系统的可用性。而Forward[2] 则认为软件文档是被软件工程师之间用作沟通交流的一种方式,沟通的信息主要是有关所开发的软件系统。Parnas[3]则强调文档的权威性,他认为文档应该提供对软件系统的精确描述。

综上,我们可以将软件文档定义为:

  1. 文档是一种对软件系统的书面描述;
  2. 文档应当精确地描述软件系统;
  3. 软件文档是软件工程师之间用作沟通交流的一种方式;
  4. 文档的类型有很种,包括软件需求文档,设计文档,测试文档,用户手册等;
  5. 文档的呈现方式有很种,可以是传统的书面文字形式或图表形式,也可是动态的网页形式

参考文献[编辑]

  1. ^ T. T. Barker, "Software documentation: from instruction to integration," IEEE Transactions on Professional Communication, vol. 33, no. 4, 1990.
  2. ^ A. Forward, "Software Documentation – Building and Maintaining Artefacts of Communication," in Ottawa-Carleton Institute for Computer Science. vol. Master in Computer Science: University of Ottawa, 2002.
  3. ^ D. L. Parnas, "Precise Documentation: The Key To Better Software," in The Future of Software Engineering: Springer-Verlag Berlin Heidelberg, 2011, pp. 125-148.