关闭

关闭

关闭

封号提示

内容

首页 软件文档管理指南

软件文档管理指南.DOC

软件文档管理指南

西北风 2012-09-05 评分 0 浏览量 0 0 0 0 暂无简介 简介 举报

简介:本文档为《软件文档管理指南doc》,可适用于IT/计算机领域,主题内容包含软件文档管理指南范围本标准为那些对软件或基于软件的产品的开发负有职责的管理者提供软件文档的管理指南。本标准的目的在于协助管理者在他们的机构中产生有效符等。

软件文档管理指南范围本标准为那些对软件或基于软件的产品的开发负有职责的管理者提供软件文档的管理指南。本标准的目的在于协助管理者在他们的机构中产生有效的文档。本标准涉及策略、标准、规程、资源和计划管理者必须关注这些内容以便有效地管理软件文档。本标准期望应用于各种类型的软件从简单的程序到复杂的软件系统。并期望覆盖各种类型的软件文档作用于软件生存期的各个阶段。不论项目的大小软件文档管理的原则是一致的。对于小项目可以不采用本标准中规定的有关细节。管理者可剪裁这些内容以满足他们的特殊需要。本标准是针对文档编制管理而提出的不涉及软件文档的内容和编排。引用标准下列标准所包含的条文通过在本标准中引用而构成为本标准的条文。本标准出版时所示版本均为有效所有标准都会被修订使用本标准的各方应探讨使用下列标准最新版本的可能性。GB计算机软件开发规范GB计算机软件产品开发文件编制指南GBT软件工程术语定义本标准采用下列定义其他定义见GBT。文档document一种数据媒体和其上所记录的数据。它具有永久性并可以由人或机器阅读。通常仅用于描述人工可读的内容。例如技术文件、设计文件、版本说明文件。文档(集)文档编制documentation一个或多个相关文档的集合。文档计划documentationplan一个描述文档编制工作方法的管理用文档。该计划主要描述要编制什么类型的文档这些文档的内容是什么何时编写由谁编写如何编写以及什么是影响期望结果的可用资源和外界因素。文档等级levelofdocumentation对所需文档的一个说明它指出文档的范围、内容、格式及质量可以根据项目、费用、预期用途、作用范围或其他因素选择文档等级。软件产品softwareproduct软件开发过程的结果并推出供用户使用的软件实体。软件文档的作用a)管理依据b)任务之间联系的凭证c)质量保证d)培训与参考e)软件维护支持f)历史档案。管理依据在软件开过过程中管理者必须了解开发进度、存在的问题和预期目标。每一阶段计划安排的定期报告提供了项目的可见性。定期报告还提醒各级管理者注意该部门对项目承担的责任以及该部门效率的重要性。开发文档规定若干个检查点和进度表使管理者可以评定项目的进度如果开发文档有遗漏不完善或内容陈旧则管理者将失去跟踪和控制项目的重要依据。任务之间联系的凭证大多数软件开发项目通常被划分成若干个任务并由不同的小组去完成。学科方面的专家建立项目分析员阐述系统需求设计员为程序员制定总体设计程序员编制详细的程序代码质量保证专家和审查员评价整个系统性能和功能的完整性负责维护的程序员改进各种操作或增强某些功能。这些人员需要的互相联系是通过文档资料的复制、分发和引用而实现的因而任务之间的联系是文档的一个重要功能。大多数系统开发方法为任务的联系规定了一些正式文档。分析员向设计员提供正式需求规格说明设计员向程序员提供正式设计规格说明等等。质量保证那些负责软件质量保证和评估系统性能的人员需要程序规格说明、测试和评估计划、测试该系统用的各种质量标准以及关于期望系统完成什么功能和系统怎样实现这些功能的清晰说明必须制订测试计划和测试规程并报告测试结果他们还必须说明和评估完全、控制、计算、检验例行程序及其他控制技术。这些文档的提供可满足质量保证人员和审查人员上述工作的需要。培训与参考软件文档的另一个功能是使系统管理员、操作员、用户、管理者和其他有关人员了解系统如何工作以及为了达到他们的各自的目的如何使用系统。软件维护支持维护人员需要软件系统的详细说明以帮助他们熟悉系统找出并修正错误改进系统以适应用户需求的变化或适应系统环境的变化。历史档案软件文档可用作未来项目的一种资源。通常文档记载系统的开发历史可使有关系统结构的基本思想为以后的项目利用。系统开发人员通过审阅以前的系统以查明什么部分已试验过了什么部分运行得很好什么部分因某种原因难以运行而被排除。良好的系统文档有助于把程序移植和转移到各种新的系统环境中。管理者的作用管理者严格要求软件开发人员和编制组完成文档编制并且在策略、标准、规程、资源分配和编制计划方面给予支持。a)管理者对文档工作的责任。管理者要认识到正式或非正式文档都是重要的还要认识到文档工作必须包括文档计划、编写、修改、形成、分发和维护等各个方面。b)管理者对文档工作的支持。管理者应为编写文档的人员提供指导和实际鼓励并使各种资源有效地用于文档开发。c)管理者的主要职责:)建立编制、登记、出版系统文档和软件文档的各种策略)把文档计划作为整个开发工作的一个组成部分)建立确定文档质量、测试质量和评审质量的各种方法的规程)为文档的各个方面确定和准备各种标准和指南)积极支持文档工作以形成在开发工作中自觉编制文档的团队风气)不断检查已建立起来的过程以保证符合策略和各种规程并遵守有关标准和指南。通常项目管理者在项目开发前应决定如下事项:要求哪些类型的文档提供多少种文档文档包含的内容达到何种级别的质量水平何时产生何种文档如何保存、维护文档以及如何进行通信。如果一个软件合同是有效的应要求文档满足所接受的标准并规定所提供的文档类型、每种文档的质量水平以及评审和通过的规程。制订文档编制策略文档策略是由上级(资深)管理者新任务并支持的对下级开发单位或开发人员提供指导。策略规定主要的方向不是做什么或如何做的详细说明。一般说来文档编制策略陈述要明确并通告到每个人且理解它进而使策略被他们贯彻实施。支持有效文档策略的基本条件:a)文档需要覆盖整个软件生存期在项目早期几个阶段就要求有文档而且在贯穿软件开发过程中必须是可用的和可维护的。在开发完成后文档应满足软件的使用、维护、增强、转换或传输。b)文档应是可管理的指导和控制文档的获得维护管理者和发行专家应准备文档产品、进度、可靠性、资源质量保证和评审规程的详细计划大纲。c)文档应适合于它的读者读者可能是管理者、分析员、无计算机经验的专业人员、维护人员、文书人员等。根据任务的执行他们要求不同的材料表示和不同的详细程度。针对不同的读者发行专家应负责设计不同类型的文档。d)文档效应应贯穿到软件的整个开发过程中在软件开发的整个过程中应充分体现文档的作用和限制即文档应指导全部开发过程。e)文档标准应被标识和使用应尽可能地采纳现行的标准若没有合适的现行标准必要时应研制适用的标准或指南。f)应规定支持工具工具有助于开发和维护软件产品包括文档。因此尽可能地使用工具是经济的、可行的。附录A中的检查表为制定策略条款或评估现有策略条款的有效性和完整性提供帮助。制订文档编制标准和指南在一个机构内部应采用一些标准和指南:软件生存期模型文档类型和相互关系文档质量。这些标准和指南决定如何实现文档任务将提供一些准则以评价机构内所产生的软件文档的完整性、可用性和适合性。尽可能地采用现行的国家和国际标准若现行的标准不适用机构应制订自己的标准。选择软件生存期模型现有的一些软件生存期模型对于不同的阶段有不同的词汇从软件文档的观点来看采用哪种模型都无关紧要只要阶段和相应的文档是清晰定义的、已计划的并且对于任何具体软件项目是能遵循的。因此管理者应选择一个软件生存期模型并保证该模型在他们机构内是适用的。管理者将会发现所进行的阶段和相应任务的定义有助于监控软件项目的进展。相应于特定阶段生成的文档可用作该阶段的评审、通过和完成的检验点而这种检验应在下一阶段开始前进行。规定文档类型和内容下面给出软件文档主要类型的大纲这个大纲不是详尽的或最后的但适合作为主要类型软件文档的检验表。而管理者应规定何时定义他们的标准文档类型。软件文档归入如下三种类别:a)开发文档描述开发过程本身b)产品文档描述开发过程的产物c)管理文档记录项目管理的信息。开发文档开发文档是描述软件开发过程包括软件需求、软件设计、软件测试、保证软件质量的一类文档开发文档也包括软件的详细技术描述(程序逻辑、程序间相互关系、数据格式和存储等)。开发文档起到如下五种作用:a)它们是软件开发过程中包含的所有阶段之间的通信工具它们记录生成软件需求、设计、编码和测试的详细规定和说明b)它们描述开发小组的职责。通过规定软件、主题事项、文档编制、质量保证人员以及包含在开发过程中任何其他事项的角色来定义做直截了当、如何做和何时做c)它们用作检验点而允许管理者评定开发进度。如果开发文档丢失、不完整或过时管理者将失去跟踪和控制软件项目的一个重要工具d)它们形成了维护人员所要求的基本的软件支持文档。而这些支持文档可作为产品文档的一部分e)它们记录软件开发的历史。基本的开发文档是:可行性研究和项目任务书需求规格说明功能规格说明设计规格说明包括程序和数据规格说明开发计划软件集成和测试计划质量保证计划、标准、进度安全和测试信息。产品文档产品文档规定关于软件产品的使用、维护、增强、转换和传输的信息。产品的文档起到如下三种作用:a)为使用和运行软件产品的任何人规定培训和参考信息b)使得那些未参加开发本软件的程序员维护它c)促进软件产品的市场流通或提高可接受性。产品文档用于下列类型的读者:用户他们利用软件输入数据、检索信息和解决问题运行者他们在计算机系统上运行软件维护人员他们维护、增强或变更软件。产品文档包括如下内容:用于管理者的指南和资料他们监督软件的使用宣传资料通告软件产品的可用性并详细说明它的功能、运行环境等一般信息对任何有兴趣的人描述软件产品。基本的产品文档包括:培训手册参考手册和用户指南软件支持手册产品手册和信息广告。管理文档这种文档建立在项目管理信息的基础上诸如:开发过程的每个阶段的进度和进度变更的记录软件变更情况的记录相对于开发的判定记录职责定义。这种文档从管理的角度规定涉及软件生存的信息。相关文档的详细规定和编写格式见GB。确定文档的质量等级仅仅依据规章、传统的做法或合同的要求去制作文档是不够的。管理者还必须确定文档的质量要求以及如何达到和保证质量要求。质量要求的确定取决于可得到的资源、项目的大小和风险可以对该产品的每个文档的格式及详细程度作出明确的规定。每个文档的质量必须在文档计划期间就有明确的规定。文档的质量可以按文档的形式和列出的要坟划分为四级。最低限度文档(级文档)级文档适合开发工作量低于一个人月的开发者自用程序。该文档应包含程序清单、开发记录、测试数据和程序简介。内部文档(级文档)级文档可用于在精心研究后被认为似乎没有与其他用户共享资源的专用程序。除级文档提供的信息外级文档还包括程序清单内足够的注释以帮助用户安装和使用程序。工作文档(级文档)级文档适合于由同一单位内若干人联合开发的程序或可被其他单位使用的程序。正式文档(级文档)级文档适合那些要正式发行供普遍使用的软件产品。关键性程序或具有重复管理应用性质(如工资计算)的程序需要级文档。级文档遵守GB的有关规定。质量方面需要考虑的问题即要包含文档的结构也要包含文档的内容。文档内容可以根据正确性、完整性和明确性来判断。而文档结构由各个组成部分的顺序和总体安排的简单性来测定。要达到这四个质量等级需要的投入和资源逐级增加质量保证机构必须处于适当的行政地位以保证达到期望的质量等级。文档编制计划文档计划可以是整个项目计划的一部分或是一个独立的文档。应该编写文档计划并把它分发给全体开发组成员作为文档重要性的具体依据和管理部门文档工作责任的备忘录。对于小的、非正式的项目文档计划可能只有一页纸对于较大的项目文档计划可能是一个综合性的正式文档这样的文档计划应遵循各项严格的标准及正规的评审和批准过程。编制计划的工作应及早开始对计划的评审应贯穿项目的全过程。如同任何别的计划一样文档计划指出未来的各项活动当需要修改时必须加以修改。导致对计划作适当修改的常规评审应作为该项目工作的一部分所有与该计划有关的人员都应得到文档计划。文档计划一般包括以下几方面内容:a)列出应编制文档的目录b)提示编制文档应参考的标准c)指定文档管理员d)提供编制文档所需要的条件落实文档编写人员、所需经费以及编制工具等e)明确保证文档质量的方法为了确保文档内容的正确性、合理性应采取一定的措施如评审、鉴定等等f)绘制进度表以图表形式列出在软件生存期各阶段应产生的文档、编制人员、编制日期、完成日期、评审日期等。附录B中的检查表为制定一个文档计划或评估现有文档计划的完整性提供帮助。此外文档计划规定每个文档要达到的质量等级以及为了达到期望的结果必须考虑哪些外部因素。文档计划还确定该计划和文档的分发并且明确叙述与文档工作的所有人员的职责。

用户评论(0)

0/200

精彩专题

上传我的资料

每篇奖励 +1积分

资料评分:

/6
0下载券 下载 加入VIP, 送下载券

意见
反馈

立即扫码关注

爱问共享资料微信公众号

返回
顶部

举报
资料