怎么写软件文档

下面的格式你可以参考一下，跟论文差不多的

主要还是要根据你实际编写的软件来写

*************************************

1.引言

1.1编写目的

1.2项目背景

1.3定义

1.4参考资料

2.2软件结构

3.程序描述

3.1功能

3.2性能

3.3输入项目

3.4输出项目

3.5算法

3.6程序逻辑

3.7接口

3.8存储分配

3.9限制条件

3.10测试要点

正文如下：

我不知道是不是有人会将阅读或书写技术文档当**好。虽然很讨厌这样做，但是通常为了解决问题或介绍一个技术产品，我们不得不去做这些事情。要想写好文档很难。技术文档有几种形式：基本概览，高级概览，一步一步的演示，自动生成的文档，等等。考虑下不同用户对你的文档的需求情况：不同的需求，不同的技术，不同的学习风格。你将会发现，没有一种格式能同时适应所有人。受众情况在写项目文档的时候，你首先要考虑到的是读者。最终用户首先需要的是一份入门指南。尽管一些技术概念可能会提到，但是重点应放在用户界面，而不是后台。如果是程序员，他可能会想得到更多的信息：程序运行原理，代码的实现，怎样对代码进行扩展，等等。为部分用户写的文档不应当影响到另一部分用户的阅读，你可以考虑写两份单独的文档，用户使用手册和技术文档。几种不同类型的文档 Jacob Kaplan-Moss在他的怎样写好文档的指南中，他提到了三种文档：教程，专题指南和参考指南。

教程：教程是很重要的，因为这往往是用户在使用新的工具时得到的第一印象。我们之前写到过，有许多不同的工具可以帮你写好教程。如果你想写的话，Kaplan-Moss建议你写得简单快速一些，但是不要太简单了，可以做一个演示，为每一步骤添加相关的截图。专题指南：Kaplan-Moss说这是文档的主要内容。虽然教程提供了一个高层次的概念，但是专题指南可以让感兴趣的人深入学习，内容一定要详尽。Kaplan-Moss提到，一般来说，图书要胜过官方文档，但是后者的一个优点是随时更新。参考指南：参考指南是为那些已经入门但是还需要更多信息的用户准备的。为那些已经知道怎样使用API，但是需要查找确切的函数参数或详细设置信息的用户定制的。要指出的是，参考指南是无法由教程和普通指南替代的。自动生成的文档只能起一个引导作用，如果没有额外的写作，编辑和组织，它是不可能解决大家的问题的。虽然这是“技术写作”，但是这并不意味着你应该放弃文采，语法和拼写检查。至少得检查一下语法和拼写吧。

按照以下格式填就好了，不过是我自己写的，有不好的地方大家互相学习修改一下~

详细设计文档规范

1.0概述

这部分提供对整个设计文档的概述。描述了所有数据，结构，接口和软件构件级别的设计。

1.1 目标和对象

描述软件对象的所有目标。

1.2 陈述范围

软件描述。主要输入，过程功能，输出的描述，不考虑详细细节。

1.3 软件内容

软件被置于商业或者产品线中，讨论相关的战略问题。目的是让读者能够对“宏图”有所了解。

1.4 主要系统参数

任何商务软件或者产品线都包含软件规定、设计、实现和测试的说明和规范。

2.0 数据设计

描述所有数据结构包括内部变量，全局变量和临时数据结构。

2.1 内部软件数据结构

描述软件内部的构件之间的数据传输的结构。

2.2 全局数据结构

描述主要部分的数据结构。

2.3 临时数据结构

为临时应用而生成的文件的描述。

2.4 数据库描述

作为应用程序的一部分，描述数据库结构。

3.0 结构化和构件级别设计

描述程序结构。

3.1 程序结构

详细描述应用程序所选定的程序结构。

3.1.1 结构图

图形化描述结构。

3.1.2 选择性

讨论其它可供考虑的结构。选定3.1.1中结构类型的原因。

3.2 构件描述

详细描述结构中的每个软件构件。

3.2.1 构件过程叙述（PSPEC）

描述构件的过程。

3.2.2 构件接口描述

详细描述构件的输入和输出。

3.2.3 构件执行细节

每个构件的详细演算描述。

3.2.3.1 接口描述

3.2.3.2 演算模型（e.g., PDL）

3.2.3.3 规范/限制

]3.2.3.4 本地数据结构

3.2.3.5 在3.2.3.6设计中包含的执行结果

3.3 软件接口描述

软件对外界的接口描述

3.3.1机器对外接口

与其他机器或者设备的接口描述。

3.3.2系统对外接口

对其它系统、产品和网络的接口描述。

3.3.3与人的接口

概述软件与任何人的界面。

4.0 用户界面设计

描述软件的用户界面设计。

4.1 描述用户界面

详细描述用户界面，包括屏幕显示图标、图片或者类型。

4.1.1 屏幕图片

从用户角度描述界面。

4.1.2 对象和操作

所有屏幕对象和操作的定义。

4.2 界面设计规范

用户界面的设计和实现的规范和标准。

4.3 可见构件

实现的GUI可见构件说明。

4.4 UIDS描述

用户界面开发系统描述。

5.0约束、限制和系统参数

会影响软件的规格说明、设计和实现的特殊事件。

6.0测试标准

测试策略和预备测试用例描述。

6.1 测试的类别

规定实施测试的类别，包括尽量详细的描述。这里是针对黑盒测试现象的描述。

6.2期待软件反馈

测试期待的结果描述。

6.3执行界线

特殊执行需要的说明。

6.4 重要构件确认

决定性构件或者需要特殊注意的构件的测试确认。

7.0附录

设计说明的补充信息。

7.1系统可跟踪矩阵

一个定期回归系统规格跟踪软件需求的矩阵。

7.2 产品战略

如果规格说明书是为一个产品设计的，描述相关的产品战略。

7.3 使用分析算法

描述所有分析活动所使用到的分析算法。

7.4 补充信息 （如果有需要特别说明的）

我是从研发步入实施的，研发需要 项目说明书 概要设计文档 详细设计文档 业务模型流程图

测试需要 测试用例 测试bug文档 迭代测试问题反馈 测试报告 压力和性能测试文档 不过小软件没有人做这些压力和性能测试 ，主要做黑盒测试，就是测试功能完整性。

实施需要 软件实施环境的需求文档 软件实施的工期计划以及各模块的具体实施计划 软件用户使用手册，让用户可以快速上手操作，最好图文并茂简单易懂，可以使用wps格式excel格式或者pdf格式，我不太看好ppt，那个真不方便做手册，希望能帮助你，谢谢！

模块开发卷宗（GB8567——88）

1标题

软件系统名称和标识符

模块名称和标识符（如果本卷宗包含多于一个的模块，则用这组模块的功能标识代替模块名）

程序编制员签名

卷宗的修改文本序号

修改完成日期

卷宗序号（说明本卷宗在整个卷宗中的序号）

编排日期（说明整个卷宗最近的一次编排日期）

2模块开发情况表

3功能说明

扼要说明本模块（或本组模块）的功能，主要是输入、要求的处理、输出。可以从系统设计说明书中摘录。同时列出在软件需求说明书中对这些功能的说明的章、条、款。

4设计说明

说明本模块（或本组模块）的设计考虑，包括：

a. 在系统设计说明书中有关对本模块（或本组模块）设计考虑的叙述，包括本模块在软件系统中所处的层次，它同其他模块的接口；

b. 在程序设计说明书中有关对本模块（或本组模块）的设计考虑，包括本模块的算法、处理流程、牵涉到的数据文卷设计限制、驱动方式和出错信息等；

c. 在编制目前已通过全部测试的源代码时实际使用的设计考虑。

5原代码清单

要给出所产生的本模块（或本组模块）的第一份无语法错的源代码清单以及已通过全部测试的当前有效的源代码清单。

6测试说明

说明直接要经过本模块（或本组模块）的每一项测试，包括这些测试各自的标识符和编号、进行这些测试的目的、所用的配置和输入、预期的输出及实际的输出。

7复审的结论

把实际测试的结果，同软件需求说明书、系统设计说明书、程序设计说明书中规定的要求进行比较和给出结论。

按照以下格式填就好了，不过是我自己写的，有不好的地方大家互相学习修改一下~

详细设计文档规范

1.0概述

这部分提供对整个设计文档的概述。描述了所有数据，结构，接口和软件构件级别的设计。

1.1 目标和对象

描述软件对象的所有目标。

1.2 陈述范围

软件描述。主要输入，过程功能，输出的描述，不考虑详细细节。

1.3 软件内容

软件被置于商业或者产品线中，讨论相关的战略问题。目的是让读者能够对“宏图”有所了解。

1.4 主要系统参数

任何商务软件或者产品线都包含软件规定、设计、实现和测试的说明和规范。

2.0 数据设计

描述所有数据结构包括内部变量，全局变量和临时数据结构。

2.1 内部软件数据结构

描述软件内部的构件之间的数据传输的结构。

2.2 全局数据结构

描述主要部分的数据结构。

2.3 临时数据结构

为临时应用而生成的文件的描述。

2.4 数据库描述

作为应用程序的一部分，描述数据库结构。

3.0 结构化和构件级别设计

描述程序结构。

3.1 程序结构

详细描述应用程序所选定的程序结构。

3.1.1 结构图

图形化描述结构。

3.1.2 选择性

讨论其它可供考虑的结构。选定3.1.1中结构类型的原因。

3.2 构件描述

详细描述结构中的每个软件构件。

3.2.1 构件过程叙述（PSPEC）

描述构件的过程。

3.2.2 构件接口描述

详细描述构件的输入和输出。

3.2.3 构件执行细节

每个构件的详细演算描述。

3.2.3.1 接口描述

3.2.3.2 演算模型（e.g., PDL）

3.2.3.3 规范/限制

]3.2.3.4 本地数据结构

3.2.3.5 在3.2.3.6设计中包含的执行结果

3.3 软件接口描述

软件对外界的接口描述

3.3.1机器对外接口

与其他机器或者设备的接口描述。

3.3.2系统对外接口

对其它系统、产品和网络的接口描述。

3.3.3与人的接口

概述软件与任何人的界面。

4.0 用户界面设计

描述软件的用户界面设计。

4.1 描述用户界面

详细描述用户界面，包括屏幕显示图标、图片或者类型。

4.1.1 屏幕图片

从用户角度描述界面。

4.1.2 对象和操作

所有屏幕对象和操作的定义。

4.2 界面设计规范

用户界面的设计和实现的规范和标准。

4.3 可见构件

实现的GUI可见构件说明。

4.4 UIDS描述

用户界面开发系统描述。

5.0约束、限制和系统参数

会影响软件的规格说明、设计和实现的特殊事件。

6.0测试标准

测试策略和预备测试用例描述。

6.1 测试的类别

规定实施测试的类别，包括尽量详细的描述。这里是针对黑盒测试现象的描述。

6.2期待软件反馈

测试期待的结果描述。

6.3执行界线

特殊执行需要的说明。

6.4 重要构件确认

决定性构件或者需要特殊注意的构件的测试确认。

7.0附录

设计说明的补充信息。

7.1系统可跟踪矩阵

一个定期回归系统规格跟踪软件需求的矩阵。

7.2 产品战略

如果规格说明书是为一个产品设计的，描述相关的产品战略。

7.3 使用分析算法

描述所有分析活动所使用到的分析算法。

7.4 补充信息 （如果有需要特别说明的）

这要看你的文档是基于什么用途的

销售用途：要有产品白皮书，产品未来方向报告，使用性能报告，兼容性报告，产品演示文稿说明

设计用途的。产品功能需求文件，产品的底层设计，产品详细设计内容。

产品用途的。产品目录，自诉文件，帮助文件，使用手册，产品授权书。

客服用途。已知问题列表，常见问题解答，危机处理指南，问题诊断指南。

有个模板可以看下

国家标准软件开发文档模板GB856T

我是从研发步入实施的，研发需要 项目说明书 概要设计文档 详细设计文档 业务模型流程图测试需要 测试用例 测试bug文档 迭代测试问题反馈 测试报告 压力和性能测试文档 不过小软件没有人做这些压力和性能测试 ，主要做黑盒测试，就是测试功能完整性。

实施需要 软件实施环境的需求文档 软件实施的工期计划以及各模块的具体实施计划 软件用户使用手册，让用户可以快速上手操作，最好图文并茂简单易懂，可以使用wps格式excel格式或者pdf格式，我不太看好ppt，那个真不方便做手册，希望能帮助你，谢谢。