3.文档的分类

    （1）开发文档：这类文档在软件项目开发过程中，体现了软件开发人员前一阶段工作的成果，同时又是后一阶段工作的依据。这类文档包括可行性研究报告、软件项目开发计划、软件需求规格说明、系统规格说明书、软件功能说明书和数据字典等。

    （2）管理文档：这类文档在软件项目开发过程中，由软件开发人员制定的需提交管理部门的一些工作计划、工作方案和工作报告。通过阅读这些文档，管理人员能够了解软件项目开发活动安排、进度、资源使用等情况。这类文档包括项目开发计划、测试计划、测试方案、开发进度报告和项目总结报告等。

    （3）用户文档：这类文档是软件开发人员为使用该软件的网点经办人员准备的有关该软件产品使用、操作的资料，主要是操作手册及新功能介绍方面的文档。

    4）投产文档：这类文档主要是软件开发人员对数据中心、分行科技人员准备的有关投产说明、版本安装、软件测试等方面的资料。

    （5）记录文档：与客户交流往来的记录、软件项目开发过程中各种会议、跟踪记录、审查记录、产品投产记录和问题跟踪解决记录等。

    （6）反馈文档：这类文档主要是软件产品在推广使用以后，客户对产品使用过程中意见及产品缺陷、质量等方面的信息反馈。

    4.文档常见问题

    （1）文档编写不够规范。主要表现在软件项目实施过程中，没有对每一个阶段的文档进行整理，分层次管理，各类文档资料缺少一个可以参照的样本，更多的是在以前他人写好的基础上，对内容进行修改一下就算完成任务。

    （2）文档内容描写不够完善。在编写各种文档过程中，虽然大家都按事先规定的模式进行了编写，但编写的内容经常不够完善，夹杂着一些旧的东西没有及时更新。特别是一些参数表、用户手册等一些由数据中心、分行使用的文档，由于一时的疏漏，造成软件项目投产失败、投产后造成系统宕机、出现账务差错、客户按照你的操作说明不能得到正确的结果等现象的发生。

    （3）对文档评审不够，使用效果不理想。按照软件工程的要求，在软件项目的开发过程中从设计到投产，要编写一系列的文档，编写这些文档是必须的，但经常会出现这样的现象，在软件开发企业，某职能部门负责人员自行制定了文档模板后，就通知各部门进行使用，结果大家反映效果不好，分析原因是没有在编写时很好地依据企业自身的现状，从实际出发征求大家的意见，对投入使用的文档没有组织相关人员进行评审。

    （4）重视文档的形式，实用性不强。在实际的软件开发过程中，要求编制的文档非常多，但编制人员没有时间去关心它们的用途，也不知道哪些部门使用，更多的是在规定的时间内完成任务，以免影响考核成绩，这样一来一些不实用的、重复的文档编制工作，占用了开发人员有效的设计开发时间，影响了项目的整体进度。因此，软件文档的制定要实用，减少繁文缛节的文字工作。

    （5）文档没有统一入库管理。随着系统的不断优化、升级，新需求的不断产生，各种文档越来越多，没有建立一个文档资料信息库，统一存放软件项目不同时期的各种文档，零散存在的文档，造成查询、统计一个软件项目完整的文档信息时非常困难。

    （6）对文档的编制重视不够。大家常常把文档作为软件产品的附件，对待文档资料没有像对待程序代码一样关注和投入，文档中普遍存在错别字、语句涵义表达不清楚，口语化浓厚，引用的图表不够准确，主题表达不够清晰等现象。

    （7）对文档的测试不足。通常测试主要是针对软件项目功能的测试，对该软件项目的文档测试则很少进行。通常用户把文档当成了软件产品的一部分，在软件产品安装使用过程中，不正确的提示信息把客户引入歧途，不但得不到预期的结果，还会产生错误，给用户带来麻烦。