1　计算机软件文档的作用

文档指的是某种数据媒体和其中所记录的数据，是计算机软件的重要组成部分之一，具有永久性的特点，在软件开发人员、软件管理人员、软件维护人员、用户以及计算机之间起着关键性的信息交换的桥梁作用。计算机软件文档的作用主要是：（1）可作为项目管理的依据，包括在项目的实现过程中和项目的管理过程中，比如一份需求规格说明书，一份详细的设计图等；（2）软件文档是技术交流的语言，因为如果没有软件文档的话，软件的开发人员之间就不能进行技术沟通，在出现困难时别人无法给予帮助，而有了软件文档，可增进开发人员之间的交流沟通；（3）软件文档是进行项目质量审查和评审的重要依据，也就是一种保证项目质量的技术文档。另外，软件文档还包含可提供对软件相关运行、维护进行配置的材料以及开展培训的相关手册，以便于管理人员、开发人员以及用户等进一步了解系统，而维护人员还可以将软件文档作为维护支持，通过软件系统的详细说明帮助用户及时找出问题所在，以适应用户需求的变化。软件文档还被称为记载软件历史的语言，不仅规范地记录了软件在整个开发过程中的全部技术信息，更为软件使用过程中面临的新需求进行必要而且可行的扩展、改造、升级提供了依据。总的来说，计算机软件文档是软件开发规范的体现和指南，因为按照相关规范或者标准编制文档的过程，就是按照软件开发的相关规范或者标准完成一个软件开发的过程。基于软件文档的上述特点和作用，在指导软件开发和维护时应该注重软件文档的编制和监督管理。

2　计算机软件在研制中应编制的软件文档

计算机软件在研制开发过程中，需要编制的软件文档从形式上来分，可以分为两大类，一类是开发中填写的各种图表，另一类是按规范需要编制的技术性资料（包括计划、进度等管理资料），称为文档或者文件。按照文档产生和使用的范围来分的话，软件文档可从开发、用户和管理三个方面进行划分。开发文档指的是在软件开发过程中形成的，如软件需求、软件设计、软件测试等一类文档。这类文档在软件开发过程中起到的作用主要是作为通信工具或者检验点，便于管理者评定软件开发进度，否则管理者将无法对软件开发进行有效的跟踪和控制，涉及到的文档主要有可行性研究报告、项目开发计划、软件需求说明书、详细设计说明书等。用户文档又叫做产品文档，指的是用来规定关于软件产品的使用和维护以及进行信息转换和传输的文档。其作用是为使用和运行相关软件产品的用户提供培训和参考信息，或者促进软件产品的市场流通或提高软件产品的可接受性，这类文档包括用于管理者的指南和资料、宣传资料及培训手册等。管理文档的作用是在对软件开发过程中的每一个阶段的进度或者变更进行记录，对软件开发的判定记录等，主要包括项目开发计划、模块开发卷宗、测试计划以及开发进度报告等。在软件开发中可以使用自然语言、特别设计的形式语言或者半形式语言以及各类图形表格来进行文档编制。

3　软件生存期各阶段和文档编制的关系

根据《计算机软件文档编制规范》（GB/T8567-2006），计算机软件在开发过程中会产生18种文件，根据《系统与软件工程用户文档的管理者要求》（GB/T16680-2015），软件在开发过程中将产生41种文档。两种规定在文档编制时机上也有所不同。按照《信息技术软件生存周期过程》（GB/T8566-2001），软件生存周期可以分成六个阶段，分别是可行性与计划研究阶段、需求分析阶段、设计阶段、实现阶段、测试阶段和运行与维护阶段。

文档的编制伴随着每个开发阶段，是整个开发过程中一个有机的组成部分。在编制的过程中，要考虑文档的读者、重复性和灵活性，一般来说，软件项目的规模、复杂性和失败风险都会直接影响软件文档编制的范围、管理手段和详细程度等。

在可行性与计划研究阶段，要依据客户提出的目标和要求，从技术、经济和法律各方面进行可行性分析，尤其要进行投资—收益分析，拟定开发计划，一般完成可行性分析报告、开发计划等文档的编制。

测试阶段标志着开发工作的结束，要对开发过程中产生的程序、文档以及开发工作本身开展全面测试，并对已编制的文档进行检查审阅。一般要完成测试分析报告、测试进度月报和项目开发总结报告等文档的编制。

在设计阶段，在反复理解软件需求的基础上，根据实际需求针对每个功能进行设计，并从软件结构的设计、模块（或CSCI）的划分、功能的分配以及处理的流程等多个方面反复推敲后，确定最终设计。在相对复杂的系统中，设计阶段应进行更为细致的分解，不仅要形成概要设计，还要细分子系统并进行详细设计，一般要完成结构设计说明、详细设计说明等文档，还要继续编制进度月报、用户手册，甚至开始测试计划的编制。

俄罗斯的政策就像是三伏的天，说变就变了，过了没有多久，就出台了好多苛刻的政策，搞什么灰色清关，实质上就是变相地折腾中国商人，强行要中国商人离境，在俄罗斯那边做生意的中国人，叫他们这么一折腾个个都损失惨重，江大亮也没有幸免，若是灰色清关政策不改变根本无法在俄罗斯待下去，在与吉尔金娜告别时，吉尔金娜骂俄罗斯那些当官的混蛋，这样一来不光给她们的生活带来极大的不便，把她的感情火焰给扑灭了。继后又可怜巴巴地问江大亮：“江，假如说万一政策宽松了，你还能回来吗？”“能，一定能，就冲你吉尔金娜，我也得回来。”吉尔金娜听后就欢快跳跃起来，说：“我真是世界上最幸福的人啦。”

在运行和维护阶段，除维持正常运行的基础性维护以外，随着现实环境的不断变化，会根据实际情况对软件原有的功能、性能等方面的设计开展必要的扩充、删减和升级，并将遇到的问题、修改的方案以及相关影响的评估等编制成开展维护的建议和软件修订的方案，尤其涉及重大更改时，应全面建立各类文档。

上文中提到的计算机软件开发过程中不同阶段所编制的文档，都需要对其进行监督管理。首先要求监督承制单位认真履行文档编制、审核以及批准等审签手续；其次要求监督承制单位按照计算机软件配置管理计划的要求对相关配置及时进行评审，在其通过后要及时纳入到软件配置管理中，至于软件的开发计划、软件的质量保证计划和软件配置管理计划等，需要监督承制单位通过签约机构的批准，对于相关计划的修整也需要通过签约机构的批准。尤其是对于软件需求说明文档的编制、软件详细设计文档的编制以及软件测试报告的编制，都需要进行正式的评审，且正式的评审还需要经过签约机构或者上级部门的主持。

在需求分析阶段，进行系统分析，确定对该软件的功能、性能等各项需求以及各类设计约束条件，明确文档编制的规范。一般来说，本阶段开始编制软件需求规格说明、用户手册、数据要求说明等相关文档。

“油品质量一定是最重要的，现在农机设备都是进口的，价格达到上百万，如果用了质量不好的油，零部件损坏，少说修一次千元，换一次就是上万元，这是一个大风险。另外，中石油服务也好，我们一直合 作很愉快。”2012年开始，一直与中国石油合作的逊克县柞树岗农机合作社理事长张凯说。

桡骨远端骨折是一种临床中十分常见的骨折类型，多发生于老年人群，摔倒和跌伤是常见原因[1]，而随着我国经济、社会的明显发展，汽车数量的明显增加、工业化的进程，使得因交通事故、工伤等造成的桡骨远端骨折的发生率较以往明显升高[2]。治疗桡骨远端骨折的方法较多，如手术、内固定及综合治疗手段等，而随着医学技术的不断进步，其治疗方法也随之更新和增多，效果也明显提高。但针对桡骨远端骨折，是否在骨折后即给予急诊干预手术，仍存在一定的争议。本研究即观察了急诊干预对桡骨远端骨折患者腕部功能的影响效果，现报道如下。

4　计算机软件文档编制的格式和内容

《计算机软件文档编制规范》（GB/T8567-2006）明确给出了25种文档的格式规范，计算机软件文档在编制过程中需要参考规范中所给出的格式和内容，但文档编制的格式和内容不是一成不变的，可以根据软件的规模和复杂程度进行必要的灵活调整。本文就以软件需求规格说明书和详细设计说明书为例对文档编制的格式和内容进行简单介绍。在编制需求规格说明书时，首先是引言，要阐明编写软件需求规格说明书的目的，可以指明读者对象，应该包括项目的委托单位、开发单位和主管部门，并列出本文档中所用到的专门术语的定义或者缩写词的原文，还要列出相关参考资料的作者、标题、编号、出版单位以及项目的计划书、合同和批文等。其次是任务的概述，包括任务目标，任务的运行环境以及任务运行所需要的条件和受到的限制等。再者是数据描述，包括静态数据、动态数据以及数据字典、数据采集等。另外，还包括功能需求、性能需求和运行需求等需求内容，比如功能需求中的功能划分，性能需求中的时间特性和适应性，运行需求中的硬件和软件接口等。详细设计说明书文档的编制同样如此，首先需要编制引言，其中包括编写的目的、项目的背景、相关术语的定义和参考资料，然后是软件结构，再者是软件模块设计说明，包括模块结构、算法概述、数据结构、程序逻辑、测试要点等。

5　计算机软件文档的管理和评审

在实现阶段，要实施源程序的编码、程序的编译（或汇编），完成软件的开发，并适时开展排错调试，进而得到无语法错误的程序代码。一般要根据项目的规模、重要性以及先后顺序开始编写进度报告，还要完成测试计划的编制，并编制面向用户的用户手册、操作手册等文档。

  

图1　文档编制过程概要

图1为文档编制过程概要。图中有两个阴影框，在第一个阴影框中的所有活动应在下一个阴影框中的活动开始之前完成。在同一阴影框中的活动可以并行执行。虚线指示可能的重复。

Essential norm of weighted composition operators from Bα spaces to LB

6　结语

参考文献：

综上所述，计算机软件系统包括程序和文档两个部分，计算机文档又起着连接计算机软件开发人员、管理人员、测试人员和用户的桥梁作用，对于软件开发研制的质量起着至关重要的作用。因此，需要对计算机软件文档进行分析研究，本文在对其作用、分类以及各类文档的编制时机、不同文档在编制时应符合规范的格式和内容、对计算机软件文档的管理和评审等几个方面进行探讨之后，发现计算机软件文档在不同的编制依据之下虽然存在微小的（比如编制时机上）的差异，但基本来说，只要在文档编制时严格参照相应的标准规范，注重编制的程序和格式内容，在软件开发研制中就不会出现文档时机编制错误、格式混乱、内容交叉或者遗漏等问题。

［1］王耀志.强化计算机文档质量监督的探讨［J］.机械管理开发，2010（5）：144-145.

(2) 稀疏性因子及迭代次数的选择.稀疏因子的作用是SNMF分解过程中控制稀疏矩阵的稀疏性,图7给出了不同稀疏因子所对应的目标函数误差(特征维数选为24,迭代次数为200).图7中可以看出:当系数因子等于0时,SNMF等价于NMF,会产生较大的目标函数误差;当目标因子不等于0时,虽然在理论上越大的稀疏因子就对应着更稀疏的稀疏矩阵,即得到最精炼的故障特征信息;目标函数的误差也随着稀疏因子的增大而增大,说明随着稀疏因子的增加,原始时频图像中所蕴含的故障特征信息损失也随之增加.

［2］杨帅玲.基于计算机软件配置管理质量监督分析［J］.中国新技术新产品，2012（12）：30-30.

［3］郑彦东.计算机信息化的影响及其软件质量管理［J］.信息与电脑：理论版，2011（1）：189-189.

［4］GB/T8567-2006.计算机软件文档编制规范［S］.2006.