计算机软件文档编制规范第2稿冯修改过底版的PPT文件格式下载.ppt

计算机软件文档编制规范第2稿冯修改过底版的PPT文件格式下载.ppt

《计算机软件文档编制规范第2稿冯修改过底版的PPT文件格式下载.ppt》由会员分享，可在线阅读，更多相关《计算机软件文档编制规范第2稿冯修改过底版的PPT文件格式下载.ppt（148页珍藏版）》请在冰豆网上搜索。

/计算机文档编制新老版本的主要差异）数据要求说明书）概要设计说明书）详细设计说明书）数据库设计说明书）用户手册）操作手册）模块开发卷宗）测试计划）测试分析报告）开发进度月报）项目开发总结报告中国电子技术标准化研究所中国电子技术标准化研究所byChinaElectronicsStandardizationInstitutehttp:

/计算机文档编制新老版本的主要差异6原则上适用于各种类型的开发方法6描述了文档编制过程6给出种文档的编制格式要求）可行性分析（研究）报告）软件开发计划）软件测试计划）软件安装计划中国电子技术标准化研究所中国电子技术标准化研究所byChinaElectronicsStandardizationInstitutehttp:

/计算机文档编制新老版本的主要差异）软件移交计划）运行概念说明）系统子系统需求规格说明）接口需求规格说明）系统子系统设计（结构设计）说明）接口设计说明）软件需求规格说明）数据需求说明）软件（结构）设计说明中国电子技术标准化研究所中国电子技术标准化研究所byChinaElectronicsStandardizationInstitutehttp:

/计算机文档编制新老版本的主要差异）数据库（顶层）设计说明）软件测试说明）软件测试报告）软件配置管理计划）软件质量保证计划）开发进度月报）项目开发总结报告中国电子技术标准化研究所中国电子技术标准化研究所byChinaElectronicsStandardizationInstitutehttp:

/计算机文档编制新老版本的主要差异）软件产品规格说明）软件版本说明）软件用户手册）计算机操作手册）计算机编程手册另外给出了面向对象的种文档的编制格式要求中国电子技术标准化研究所中国电子技术标准化研究所byChinaElectronicsStandardizationInstitutehttp:

/计算机文档编制四、6标准结构、范围、规范性引用文件、术语和定义、缩略语、文档（编制）过程、文档编制要求、文档编制格式附录面向对象软件的文档编制中国电子技术标准化研究所中国电子技术标准化研究所byChinaElectronicsStandardizationInstitutehttp:

/计算机文档编制五、文档（编制）过程五、文档（编制）过程5.15.1概述概述有两种主要类型的标准：

a.产品标准，它规定产品的特征和功能需求；

b.过程标准，它规定开发产品的过程。

应用程序和计算机软件的复杂性日益增加，使得给使用计算机的用户提供完整的、正确的和易懂的文档的需要更加迫切。

本标准通过规定影响软件文档的质量的活动（做什么和由谁做），提供达到这些目的的工具。

/计算机文档编制文档常常是关心在软件已经实现后做些什么。

然而，为了质量，软件文档编制应作为整个软件生产过程的一部分。

过程计划应把文档计划包括在内。

本标准也给用户和客户提供工具以保证文档过程实施。

本标准的主要活动是建立开发文档的广泛计划。

这是必须的，因为有计划，文档编制的质量会更好，过程的效率会更高。

为遵循本标准，计划必须包括风格规格说明。

本标准不规定风格规格说明的内容（即不规定具体的布局和字体），但它规定风格规格说明必须覆盖什么。

本标准也规定何种信息对于文档管理者是可用的和谁做评审和再生产文档。

/计算机文档编制5.25.2文档（编制）过程的关注点文档（编制）过程的关注点文档编制计划文档开发（编制）文档评审中国电子技术标准化研究所中国电子技术标准化研究所byChinaElectronicsStandardizationInstitutehttp:

/计算机文档编制5.35.3文档计划文档计划5.3.1概要文档管理者应准备一文档计划，此计划规定在文档创建中要执行的工作。

此文档计划应经需方正式同意，以预示它完全覆盖了需方的要求。

l文档计划通常将覆盖整个文档系列。

文档计划应正式地描述计划的文档的范围和限制，以及重要的文档分析和设计决定。

也应规定在文档开发期间实现的过程和控制。

/计算机文档编制文档计划应包括（但不限于）以下内容：

a）计划的文档的工作名称、目的、范围和限制。

b）文档的预定的读者，和使用的目的。

c）文档内容的草案表，带有估计的页数和其他媒体的等效细节。

d）交付：

打印副本数，是否提供电子副本，磁盘和文件格式（包括软件版本）和在何处交付。

e）版权的拥有者和任何其他所有权。

l这是复杂的问题，应在合同中规定。

/计算机文档编制f）适当处，包括每个文档的安全或机密级。

g）管理文档开发过程的步骤和控制，包括存储、检索、后备、处理和质量保证（若要求）。

h）所用的生产方法、工具和工具版本。

i）文档开发人员所在的队伍的结构，任选地，包括队伍选择计划。

l在文档编写和生产的不同阶段中的工作人员，需要不同的技巧。

编写人员可能要求对正在编写的系统有好的知识加上写文档的经验；

编辑人员可能要求有编辑经验而对系统知识无要求；

版面艺术家可能对所用的版面工具外，无任何知识要求。

/计算机文档编制j）项目依赖。

k）所要求的人时和成本。

l）项目资源需求，包括需方提供的信息和其他资源。

m）在软件开发期间，软件变更传送信息给文档管理者的方法。

n）文档的变更控制和维护的计划（任选）。

o）实现后评审的计划（任选）。

/计算机文档编制p）显示适当的里程碑的时间表，包括：

1）文档计划批准；

对于文档的每一项应重复。

l文档计划宜2）每个草案的准备、评审和改正；

3）可用性测试；

4）打印、装订和发布。

若适当，这些活动的每一个在文档的开发开始以前准备与批准，以保证所有部门同意目标和所用的方法。

批准后，计划宜尽可能广泛地分发；

分发宜包括所有文档开发人员和可能包括需方人员及子合同方。

/计算机文档编制5.3.2文档计划控制在正式同意后，文档管理者应控制文档计划和它的发布。

文档管理者应保持一份文档计划副本的分发的清单。

若以后文档计划变更了（得到文档管理者和需方的同意），文档管理者应保证所有得到文档计划副本的人员，应得到变更通知。

l因为，计划的过时的副本可能引起问题，文档管理者宜禁止计划的未控制的副本并制订计划的所有副本已经更新的审核过程。

/计算机文档编制5.45.4文档开发文档开发按文档计划规定进行文档开发。

通常，在进行文档开发前，要规定文档的格式（风格）。

在软件的开发和管理过程中需要那些文档，每种文档的规范在下面说明。

/计算机文档编制5.55.5评审评审5.5.1概述本节规定文档评审的要求和相关活动。

本节主要以用户文档的评审为例说明。

对于开发文档的评审，由供方组织和实施。

而批准由开发组织的上级技术机构实施。

更要着重经常性的、非正式的注重实效的评审。

不是要追求形式。

/计算机文档编制用户文档的评审应由需方实现，包括当需要时与文档管理者讨论。

l评审的目的是保证提交的材料是完整的和正确的并满足了在合同和文档计划中定义的需方的需要。

评审宜由合适的有资格的人员执行，这些人员被授权请求变更和批准文档的内容。

l需方宜限止评审人员数为评审功能所必需的那些。

需方在批准每个用户文档草案之前，应保证文档的安全和合法。

为评审交付的文档应包括从文档管理者来的说明书，说明评审的目的和评审员的职责。

/计算机文档编制l注1：

在需方和文档管理者之间在整个开发过程期间维持良好的通信会提高文档的质量并利于评审成功。

这宜包括非正式的讨论和尽早地提供样板或初始材料给需方。

l注2：

在要求的变更超出了合同和文档计划的范围时，需要变更合同。

l注3：

评审过程不免除文档管理者，他们的责任是试图尽可能保证文档的精确和完整。

l注4：

从评审的结果而来的需方的评论结果宜用或是加上标记的草案或用有适当的参考的方式写评论。

需方宜保持变更的副本为了与下一草案相比较。

评论应使文档开发人员能实现所要求的变更而不需要评审人员的进一步解释。

l注5：

对于大的、复杂的系统或正在写文档时系统仍在开发，可能需要多于两次草案和一次校样。

在这样情况下，最多的草案数宜在需方和文档管理者之间同意并在文档计划中规定。

中国电子技术标准化研究所中国电子技术标准化研究所byChinaElect