计算机软件产品开发文件编制指南 GB 8567-88

附录O
                              文件给制实施规定的实例
                                        （参考件）
   尽管在文件编制中存在着很多灵活性，然而，文件的编制确实是非常必要的，其意义如前所述。为了控制这种灵活性，保证文件编制能达到应该达到的目的，对于具体的软件开发任务，应编制的文件的种类、详细程度应取决于承担开发单位的管理能力、任务的规模、复杂性和成败风险等因素。一个软件开发单位应该根据本单位经营承包的应用软件的专业特点和本单位的管理能力，制定一个文件编制实施规定，说明在什么情况下应该编制哪些文件。由于国内目前在这方面还缺乏成熟的经验，这里提供参考国外经验制定的两个例子，用以向国内软件开发单位说明如何建立这种实施规定，使项目负责人能确定本项目开发过程中应编制的文件的种类。当然，例子毕竟只是例子，这两个例子各自都不免有其片面性，它们两者之间也不免有不一致之处，之所以列出来无非是供国内软件开发单位参考。
   例1：
   此例规定用求和法来确定应编制的文件。该方法的要点是提出十二个考虑因素来衡量一个应用软，件，每个因素可能取值的范围是互至5。任务负责人可用这十二个因素对所要开发的程序进行衡量，确定每个因素的具体值。把这十二个因素的值相加，得到一个总和。然后由这个总和的值来确定应该编制的文件的种类。使用这个方法的具体过程如下：
   a. 按表OI中的十二个因素衡量所要开发的程序，得到每个因素的值;
   b．把衡量所得的各个因素的值相加，得总和之值；
   c. 根据总和之值，从表OZ查出应编制的文件的种类。
                   表OI文件编制的十二项衡量因素

                         表 O1 文件编制的十二项衡量因素
                  

    *在因素总和较低的情况下,项目开发总结报告的内容应包括：程序的主要功能、基本流程、测试结果和使用说明。         
  **测试分析报告应该写，但不必很正规。
* **数据要求说明和数据库设计说明是否需要编写应根据所开发软件的实际需要来决定。
   例2：
   为了避免在软件开发中文件编制的不足或过分，一个简便的办法是把对软件文件的编制要求同软件的规模大小联系起来，这就是本例的出发点。软件的规模不妨分为四级：
   1．小规模软件源程序行数小于5 000的软件；
   2．中规模软件源程序行数为 10 000～ 50 000的软件；
   3．大规模软件源程序行数为 100 000—500 000的软件；
   4．特大规模软件源程序行数大于500 000的软件。
   对上述的四级软件的文件编制要求分别列于表O3。
   至于源程序行数为 5 000～ 10 000， 50 000～ 100 000的软件，其文件编制要求介于两级之间，可根据一个软件产品的具体情况，由项目负责人参照表O3的规定，确定需要编制的文件种类。
   对于源程序行数大于500 000的特大规模软件，可进一步把本指南规定的十四种文件按实际需要扩展成更多种类，这一点在本指南5．3．3已经提到。
        
   附加说明：
   本标准由中华人民共和国电子工业部提出。
   本标准由中国软件技术公司负责起草。
   本标准主要起草人应明、崔涛、刘林。