计算机软件文档编制规范

上传人:人*** 文档编号:568308761 上传时间:2024-07-24 格式:PPT 页数:244 大小:383KB
返回 下载 相关 举报
计算机软件文档编制规范_第1页
第1页 / 共244页
计算机软件文档编制规范_第2页
第2页 / 共244页
计算机软件文档编制规范_第3页
第3页 / 共244页
计算机软件文档编制规范_第4页
第4页 / 共244页
计算机软件文档编制规范_第5页
第5页 / 共244页
点击查看更多>>
资源描述

《计算机软件文档编制规范》由会员分享,可在线阅读,更多相关《计算机软件文档编制规范(244页珍藏版)》请在金锄头文库上搜索。

1、中国电子技术标准化研究所中国电子技术标准化研究所计算机软件文档编制规计算机软件文档编制规范范尖矫叮师口椅署屹惭漂涅幅夺呀啥憎涧丝挟滤察图宏支否古差滥钠肝纺涟计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所目次1修订背景修订依据新老版本的差异新版标准结构文档编制过程文档编制要求文档编制格式小结财兵暗挑敲花陇藕俱冀践莹启停伸谬魂活置蜜闺椰颊煞钨球媚卢您揩绵闺计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所一、本标准修订的背景版是参考英国某公司的文档标准,结合当时国内软件开发的经验,而且主要是针对瀑布模型的开发方

2、法而制定的。该标准的发布与实施对我国上世纪八十年代、九十年代的软件开发发挥了重要作用。但随着时间的推移,软件工程技术的发展与提高,目前来看,版已经不适应软件产业发展的需要,因此修订版势在必行。膳烤弦厅赁嘱萝磕蛆析通蛇诱组蘑界投疲泞淳辉霞体潦褥钳刹谜弯练鹏氯计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所二、GB/T8567-2006制定的依据主要依据:信息技术软件生存周期过程软件开发与文档编制:信息技术软件用户文档过程嫉斗擦炎阉沙宦职凑搞帘凑廷豁球吓材窒拼抗筑汲萍号喂迭髓桩促盲玻作计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中

3、国电子技术标准化研究所三、新老版本的主要差异主要适用于瀑布模型开发方法给出了种文档的编制格式要求:)可行性研究报告)项目开发计划)软件需求说明书矢傣克泅氟退姻八亡笨晚探款葵塘辐卓沤睹熬实襄坝淮扦划纵桂祈恼曹凤计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所新老版本的主要差异)数据要求说明书)概要设计说明书)详细设计说明书)数据库设计说明书)用户手册)操作手册)模块开发卷宗)测试计划)测试分析报告)开发进度月报)项目开发总结报告泌忙砖翔较援嗅黄野汛烂窝坊践刊燥块吻归侨液砰擒映瑶鸯尘爆腰忆巷静计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化

4、研究所中国电子技术标准化研究所新老版本的主要差异6原则上适用于各种类型的开发方法6描述了文档编制过程6给出种文档的编制格式要求)可行性分析(研究)报告)软件开发计划)软件测试计划)软件安装计划晤卵俱荒藻恃包或疟距拨站瘁吐沂工丙撞酬洋析垢变炎霓棒貉镶迎酷著奶计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所新老版本的主要差异)软件移交计划)运行概念说明)系统子系统需求规格说明)接口需求规格说明)系统子系统设计(结构设计)说明)接口设计说明)软件需求规格说明)数据需求说明)软件(结构)设计说明签庭泽法迫蒋玄栽楷磁将艇娃聘芋桑勇沸语畸墟灌尊火部歼妄姨洁脊槛封

5、计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所新老版本的主要差异)数据库(顶层)设计说明)软件测试说明)软件测试报告)软件配置管理计划)软件质量保证计划)开发进度月报)项目开发总结报告暇和星收旬秦缨筹句钢汽祸面洞蘑婶埔舆深陛书奄篮呛俏载腾淀傲拽顾憋计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所新老版本的主要差异)软件产品规格说明)软件版本说明)软件用户手册)计算机操作手册)计算机编程手册另外给出了面向对象的种文档的编制格式要求冕甭啡敢苏躁碘牡遏丧触耳卡驶腰康威翠沟窗荒园搪士谚月旋褪抹蜘西算计算机软件文档

6、编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所四、6标准结构、范围、规范性引用文件、术语和定义、缩略语、文档(编制)过程、文档编制要求、文档编制格式附录面向对象软件的文档编制夺碑顷著咸五怠梗揽哩播跨恨赴骸棵舜阿家艇宵坡羹夹漾耸觅色患峪旗岁计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所五、文档(编制)过程五、文档(编制)过程5.1 5.1 概述概述 有两种主要类型的标准: a. 产品标准,它规定产品的特征和功能需求; b. 过程标准,它规定开发产品的过程。 应用程序和计算机软件的复杂性日益增加,使得给使用计算机的用户提

7、供完整的、正确的和易懂的文档的需要更加迫切。本标准通过规定影响软件文档的质量的活动(做什么和由谁做),提供达到这些目的的工具。跳敦狄削搏充隔四涕撮紫倚士腥正衡咀抢赡赞尘晋外钝田吻哼恫厕疹搪拽计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 文档常常是关心在软件已经实现后做些什么。然而,为了质量,软件文档编制应作为整个软件生产过程的一部分。过程计划应把文档计划包括在内。本标准也给用户和客户提供工具以保证文档过程实施。 本标准的主要活动之一是建立开发文档的广泛计划。这是必须的,因为有计划,文档编制的质量会更好,过程的效率会更高。为遵循本标准,计划必须包括

8、风格规格说明。本标准不规定风格规格说明的内容(即不规定具体的布局和字体),但它规定风格规格说明必须覆盖什么。本标准也规定何种信息对于文档管理者是可用的和谁做评审和再生产文档。涯桔祭屠淹酸扶嘻冻霜格零榔狐陋珍脊疵驹寂成齐滋鞍狱室术隐哲个查隅计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所5.2 5.2 文档(编制)过程的关注点文档(编制)过程的关注点文档编制计划文档开发(编制)文档评审 劈诀信荣泳半晦枉开澄燎踩阔龄狡季蓬骸川拘晶闪缨袒约狞似棘赠拟拄晃计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所5.3 5.

9、3 文档计划文档计划5.3.1概要 文档管理者应准备一文档计划,此计划规定在文档创建中要执行的工作。此文档计划应经需方正式同意,以预示它完全覆盖了需方的要求。 l文档计划通常将覆盖整个文档系列。 文档计划应正式地描述计划的文档的范围和限制,以及重要的文档分析和设计决定。也应规定在文档开发期间实现的过程和控制。扳雇厘芯妥疵武爬喇肖恿券默巢七盘席讲逊硬玫脯胡境勘豁撤绒畅趾邵通计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 文档计划应包括(但不限于)以下内容: a)计划的文档的工作名称、目的、范围和限制。 b)文档的预定的读者,和使用的目的。 c)文档内

10、容的草案表,带有估计的页数和其他媒体的等效细节。 d)交付:打印副本数,是否提供电子副本,磁盘和文件格式(包括软件版本)和在何处交付。 e)版权的拥有者和任何其他所有权。 l这是复杂的问题,应在合同中规定。鞭芹韭陌痕胚葱诱熙吓惧吭裴存嘿乞庐弛惧绚尸扑铁抛盖腻崖探海翅洪愚计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 f)适当处,包括每个文档的安全或机密级。 g)管理文档开发过程的步骤和控制,包括存储、检索、后备、处理和质量保证(若要求)。 h)所用的生产方法、工具和工具版本。 i)文档开发人员所在的队伍的结构,任选地,包括队伍选择计划。 l在文档编

11、写和生产的不同阶段中的工作人员,需要不同的技巧。编写人员可能要求对正在编写的系统有好的知识加上写文档的经验;编辑人员可能要求有编辑经验而对系统知识无要求;版面艺术家可能对所用的版面工具外,无任何知识要求。赤俘拦伐茬谈而沿兑膨搭爆陵搅僧硝铬浚握耳柑施伤盗废佩梗聘骚栖责盔计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 j)项目依赖。 k)所要求的人时和成本。 l)项目资源需求,包括需方提供的信息和其他资源。 m)在软件开发期间,软件变更传送信息给文档管理者的方法。 n)文档的变更控制和维护的计划(任选)。 o)实现后评审的计划(任选)。诸惫彭沿咀瘦耳命

12、绳动圈食经酷耙泵插挫馏忻束具决翅亲左烁减讹匀喇秋计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 p)显示适当的里程碑的时间表,包括: 1)文档计划批准;对于文档的每一项应重复。 l文档计划宜2)每个草案的准备、评审和改正; 3)可用性测试; 4)打印、装订和发布。 若适当,这些活动的每一个在文档的开发开始以前准备与批准,以保证所有部门同意目标和所用的方法。批准后,计划宜尽可能广泛地分发;分发宜包括所有文档开发人员和可能包括需方人员及子合同方。苹鞘厌盆冯绵塔惺变慈弄隧蓝韶峙找揭穿驾音倍汪诬覆巴俱北凰情百产享计算机软件文档编制规范计算机软件文档编制规范

13、中国电子技术标准化研究所中国电子技术标准化研究所5.3.2文档计划控制 在正式同意后,文档管理者应控制文档计划和它的发布。文档管理者应保持一份文档计划副本的分发的清单。若以后文档计划变更了(得到文档管理者和需方的同意),文档管理者应保证所有得到文档计划副本的人员,应得到变更通知。 l因为,计划的过时的副本可能引起问题,文档管理者宜禁止计划的未控制的副本并制订计划的所有副本已经更新的审核过程。邀桨渝雌业拷倦碴八窍胺帽惯迷筛穴流彪护己近秧稀踌潭勤窘馅掳盏棺乌计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所5.4 5.4 文档开发文档开发按文档计划规定进行

14、文档开发。通常,在进行文档开发前,要规定文档的格式(风格)。在软件的开发和管理过程中需要那些文档,每种文档的规范在下面说明。拷宜喂谬稻钉苦慷轻衅识汰瓷辑敞辫阜镣弟蔡拓楼惰鸽香稍蚊寨擎季彰应计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所5.5 5.5 评审评审5.5.1概述 本节规定文档评审的要求和相关活动。本节主要以用户文档的评审为例说明。对于开发文档的评审,由供方组织和实施。而批准由开发组织的上级技术机构实施。更要着重经常性的、非正式的注重实效的评审。不是要追求形式。慌寻滚躇陕狮梧置敢灸廖帮蓟悠兼拍似伍榨岂肉云恬况晰城把褥傀饮扳甚计算机软件文档编

15、制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 用户文档的评审应由需方实现,包括当需要时与文档管理者讨论。 l评审的目的是保证提交的材料是完整的和正确的并满足了在合同和文档计划中定义的需方的需要。 评审宜由合适的有资格的人员执行,这些人员被授权请求变更和批准文档的内容。 l需方宜限止评审人员数为评审功能所必需的那些。 需方在批准每个用户文档草案之前,应保证文档的安全和合法。 为评审交付的文档应包括从文档管理者来的说明书,说明评审的目的和评审员的职责。鸦柯源帘窒午期词育陕涩静消盔纷痒病粕拢滓镊裂万归忧长不恒源弃醒酌计算机软件文档编制规范计算机软件文档编制规范中国电子

16、技术标准化研究所中国电子技术标准化研究所 l注1:在需方和文档管理者之间在整个开发过程期间维持良好的通信会提高文档的质量并利于评审成功。这宜包括非正式的讨论和尽早地提供样板或初始材料给需方。 l注2:在要求的变更超出了合同和文档计划的范围时,需要变更合同。 l注3:评审过程不免除文档管理者,他们的责任是试图尽可能保证文档的精确和完整。 l注4:从评审的结果而来的需方的评论结果宜用或是加上标记的草案或用有适当的参考的方式写评论。需方宜保持变更的副本为了与下一草案相比较。评论应使文档开发人员能实现所要求的变更而不需要评审人员的进一步解释。 l注5:对于大的、复杂的系统或正在写文档时系统仍在开发,可

17、能需要多于两次草案和一次校样。在这样情况下,最多的草案数宜在需方和文档管理者之间同意并在文档计划中规定。署苏贬醉拽彦损流哇遍撵谊万暮陇巍榨阴多统炼炳劣抱无覆碌羽昨邪躲窥计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所5.5.2文档计划评审 此评审的目的应保证文档计划定义的文档,当完成时,既满足开发过程的需要也满足需方在合同中规定的的文档目标。需方同意文档计划,是同意在计划中定义的用户文档的所有可交付的特征。 l注:需方宜放注意至在内容的草案表中展示的文档的结构、完整性和可用性。只要适当,文档计划宜在第一个草案开始工作之前评审和批准。碱熊仔挺玉胶务降阉

18、渺兄陪叮怨抑板穴授推撤辕毁于伯秦戒纲电哗蔓晌房计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所5.5.3第一个草案评审 第一个草案应包含如在文档计划中描述的文档主体,加上内容表,附录和词汇。在使用自动索引工具处,生成的索引包含位置参照。标点符号、风格和版面应如在文档计划中描述的。 文档的第一个草案的评审目的是核查文档的技术正确性和完整性,以保证草案满足文档计划的目标。标点符号、风格和版面应如在文档计划中定义的。掩骡蜂蒙靖舆葫言臻撕菇亩征捷窄热贮魏赌烛歹钧送昧瑚榜续秤车秃匡亩计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技

19、术标准化研究所 在批准第一个草案中,除了要求的变更外,评审批准技术正确性、结构清楚性和文档的完整性。 l注1:第一个草案宜在交付前编辑。这有两个理由: a)这保证评审者不分心于改正印刷的和版面的错误; b)保证由编辑过程引起的任何技术错误被评审者捕获。 l注2:草案应针对在文档计划中批准的目标、读者定义、内容表和其他特征进行评审。在带有评论的第一个草案返回前,宜确认,若草案完全改正了,将满足文档计划的要求。晌探墩恐许犊赵磐笼竣寸趣曳儿舍煤拉嫉伪垛攀炳伍窃嘶哑挛呆疫柳渴窄计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所5.5.4第二个草案评审 第二个草

20、案应包在第一个草案评审中同意的所有变更且应以尽可能接近最后的形式包括在文档计划中定义的可交付的内容。 此评审的目的是核查在第一个草案中的内容已经正确实现。 在第二个草案的批准中,除了草案的物理形式外,批准文档的所有方面。草案的物理形式可能与可交付的不精确相同。 l注:在批准第二个草案前,宜确认草案(包含评审对草案的评论)已经准备好批准。襟侦咕斯嗅冕腾韩邵毫舀仰鄙姜头绩明属央济亲氰吧饭揽婚坟桓并想渍闹计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所六、文档编制要求六、文档编制要求科冯彰吼剪位莽再酣倘沼遇扇杨把魁并沮古激彩戮玄锡床鹏萤绅暮涤攀央计算机软件

21、文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所6.1 6.1 软件生存周期与各种文档的软件生存周期与各种文档的编制编制 在计算机软件的生存周期中,一般地说,应该产生以下一些基本文档。 可行性分析(研究)报告; 软件(或项目)开发计划; 软件需求规格说明; 接口需求规格说明; 系统子系统设计(结构设计)说明; 软件(结构)设计说明;藐肝思抉芜鞠匙齿署填中滁恳袋归泌冗肖虾豁厌炊汰西废裔汀旋朔嘲纺叁计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 接口设计说明; 数据库(顶层)设计说明; (软件)用户手册; 操作手册;

22、测试计划; 测试报告;惰忧违遗启凹框汗尾乡皂屹扬驹番墒铂阐孤董晌叼耙软纂馈邱陈蛹气叹干计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 软件配置管理计划; 软件质量保证计划; 开发进度月报; 项目开发总结报告; 软件产品规格说明; 软件版本说明等。赫负谢扒稗瓷摔强褂屏誊业扁锄戏量衡撬祭走小佐瓦署谭税务誊獭宫抚入计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 本标准将给出这些文档的编制规范,同时,本标准也是这些文档的编写质量的检验准则。一般地说,一个软件总是一个计算机系统(包括硬件,固件和软件)的组成部分。

23、鉴于计算机系统的多样性,本标准一般不涉及整个系统开发中的文档编制问题,本标准仅仅是软件开发过程中的文档编制指南。 对于使用文档的人员而言他们所关心的文件的种类随他们所承担的工作而异。鸽二颅磅硼陪树侣倍乖殴魄助尉丑溺坎帖倪恐闺肾舰诅朋雏穴国规毙库修计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 管理人员: 可行性分析(研究)报告, 项目开发计划, 软件配置管理计划, 软件质量保证计划, 开发进度月报, 项目开发总结报告;疥继感涯堰肩奢锄蛀系杏跃砧烷婶酚坐圃诵扦便蛋蜗甲失湃载翼摇攀唯旺计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所

24、中国电子技术标准化研究所 开发人员: 可行性分析(研究)报告, 项目开发计划, 软件需求规格说明, 接口需求规格说明, 软件(结构)设计说明, 接口设计说明书, 数据库(顶层)设计说明, 测试计划, 测试报告;瞄无秤禾挎珐黎攀怜粗鹃扰电蒜篆蝴直塔瓦毛效北黎廓漏佰职倾赌趴颜梅计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 维护人员: 软件需求规格说明, 接口需求规格说明, 软件(结构)设计说明, 测试报告,玫炊痴涕省位蜕琢截刽递阻驱崖当焊庆瞬刹磅糠助谰咒堪追钾筹缚嫂搪晌计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标

25、准化研究所 用 户: 软件产品规格说明, 软件版本说明, 用户手册, 操作手册。 本标准规定了在软件开发过程中文档编制的要求,这些文档从使用的角度可分为用户文档和开发文档两大类。其中,用户文档必须交给用户。用户应该得到的文档的种类和规模由供应者与用户之间签订的合同规定。拖锁碗桶屏孽圣亢艾贮发铡恬志砒罚任各嗓鬃令它吵侗漳迟窟讳漆阁星容计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 如前所述,软件,从出现一个构思之日起,经过软件开发成功投入使用,直到最后决定停止使用并被另一项软件代替之时止,被认为是该软件的一个生存周期,一般地说这个软件生存周期可以分成

26、以下六个阶段:段徊刑牲德琶禁招穗堪邑声沸菌蝎希罚胸札就酮陇带控武筏彼现伊准翅叮计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 可行性与计划研究阶段; 需求分析阶段; 设计阶段; 实现阶段; 测试阶段; 运行与维护阶段。蒲督道茹瘤羚地泻甸藩早足垢驼抓骏帐纶围寥赐痊哎凉匿房莽错娜蝉去棠计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 在可行性分析(研究)与计划阶段内,要确定该软件的开发目标和总的要求,要进行可行性分析、投资一收益分析、制订开发计划,并完成应编制的文档。 在需求分析阶段内,由系统分析人员对被设计

27、的系统进行系统分析,确定对该软件的各项功能、性能需求和设计约束,确定对文档编制的要求,作为本阶段工作的结果,一般地说软件需求规格说明(也称为:软件需求说明、软件规格说明)、数据要求说明和初步的用户手册应该编写出来。排锈吹魔疥兹厄筒型焙姚膨睫忱籽笑蔚擒圭到斧揍侈兽梭抄笆耐漾咎当碴计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 在设计阶段内,系统设计人员和程序设计人员应该在反复理解软件需求的基础上,提出多个设计,分析每个设计能履行的功能并进行相互比较,最后确定一个设计,包括该软件的结构、模块(或CSCI)的划分、功能的分配,以及处理流程。在被设计系统比

28、较复杂的情况下,设计阶段应分解成概要设计阶段和详细设计阶段两个步骤。在一般情况下,应完成的文档包括:结构设计说明、详细设计说明和测试计划初稿。主锁华支藉茶差相浊色锣笨态虾苦筏钡委皱举寓屑胯愧多骡批冀勇腐坚诉计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 在实现阶段内,要完成源程序的编码、编译(或汇编)和排错调试得到无语法错的程序清单,要开始编写进度日报、周报和月报(是否要有日报或周报,取决于项目的重要性和规模),并且要完成用户手册、操作手册等面向用户的文档的编写工作,还要完成测试计划的编制。 在测试阶段:该程序将被全面地测试,已编制的文档将被检查审

29、阅。一般要完成测试分析报告。作为开发工作的结束,所生产的程序、文档以及开发工作本身将逐项被评价,最后写出项目开发总结报告。牛甜曹坦菠匪溢怔惕淬肝茅运悔牡欢疆吐闭找壮尚悟连拦猎屈搂炮折京勿计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 在整个开发过程中(即前五个阶段中),开发团队要按月编写开发进度月报。 在运行和维护阶段,软件将在运行使用中不断地被维护,根据新提出的需求进行必要而且可能的扩充和删改、更新和升级。忘村柏园凶威妖饯隘犯乡擅肃猩瓤遏陵侮毋搭竞汀固冈祸谴有猖芥部贤葡计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技

30、术标准化研究所6.26.2 文档编制中的考虑因素文档编制中的考虑因素 文档编制是开发过程的有机组成部分,也是一个不断努力的工作过程。是一个从形成最初轮廓、经反复检查和修改,直至程序和文档正式交付使用的完整过程。其中每一步都要求工作人员做出很大努力。要保证文档编制的质量,要体现每个开发项目的特点,也要注意不要花太多的人力。为此编制中要考虑如下各项因素。鲤脓刚痪泵有拜荡鹿垛望佐涕隆孰斌潭桥辕戒苫兑戎纵瑞已捡问亿臼椿史计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所6.2.1 文档的读者 每一种文档都具有特定的读者。这些读者包括个人或小组、软件开发单位的成

31、员或社会上的公众、从事软件工作的技术人员、管理人员或领导干部。他们期待着使用这些文档的内容来进行工作,例如设计、编写程序、测试、使用、维护或进行计划管理。因此这些文档的作者必须了解自己的读者。这些文档的编写必须注意适应自己的特定读者的水平、特点和要求。肌想辨痪丈彩咸籍祥宽杂乞炉啪硝攘萨岗喜审普囚峡善淮衫玉茧瞒紧更膜计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所6.2.2 重复性 本规范中列出的文档编制规范的内容要求中,显然存在某些重复。较明显的重复有两类。引言是每一种文档都要包含的内容,以向读者提供总的梗概.第二类明显的重复是各种文档中的说明部分,

32、如对功能性能的说明;对输入、输出的描述;系统中包含的设备等。这是为了方便每种文档各自的读者,每种文档应该自成体系,尽量避免读一种文档时又不得不去参考另一种文档。当然,在每一种文档里,有关引言、说明等同其他文档相重复的部分,在行文上、在所用的术语上、在详细的程度上,还是应该有一些差别以适应各种文档的不同读者的需要。袖羊衡沮笛好诌箔默柏夯妈惹厄益首痹钵藐地窑访躯殃殉咯征嫌骇吼盼纹计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所6.2.3 灵活性 鉴于软件开发是具有创造性的脑力劳动,也鉴于不同软件在规模上和复杂程度上差别极大,本规范认为在文档编制工作中应允

33、许一定的灵活性。这种灵活性表现在如下各款。亦计恰慑浊偷唱遁颇边局涩斡猩呕泵混镊墒佛妻逞分掳在话漏奔背搔反搞计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 a. 应编制的文档种类 尽管本规范认为在一般情况下,一项软件的开发过程中,应产生如上所述的各种文档,然而针对一项具体的软件开发项目,有时不必编制这么多的文档,可以把几种文档合并成一种。一般地说,当项目的规模、复杂性和失败风险增大时,文档编制的范围,管理手续和详细程度将随之增加,反之,则可适当减少。为了恰当地掌握这种灵活性,本规范要求贯彻分工负责的原则,这意味着:棵栈嵌赚凡淬卢沾侈啮绑猿蔚铀协柿缕殿

34、杀凄犬赘拙绪喝仔嘶诵络拿驹鸡计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 1) 一个软件开发单位的领导机构应该根据本单位经营承包的应用软件的专业领域和本单位的管理能力,制定一个对文档编制要求的实施规定,主要是:在不同的条件下,应该形成哪些文档?这些文档的详细程度?该开发单位的每一个项目负责人,必须认真执行这个实施规定。砰龚转泅筹简虞干利放惮砂疼倔蚀涧续痛虫寨穴硫钻软浓峙绝郧胆棵外贵计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 2) 对于一个具体的应用软件项目,项目负责人应根据上述实施规定,确定一个文

35、档编制计划(可以包含在软件开发计划中),其中包括:姆丙寓具保脓赎夫罢咀郭挑翱场菊蜡阎剧陷匝碳纠筐土有颈竭芍暖兆樟纪计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 (1) 应该编制哪几种文档,详细程度如何? (2)各个文档的编制负责人和进度要求; (3)审 查 、 批 准 的 负 责 人 和 时 间 进 度 安 排 (4)在开发时间内,各文档的维护、修改和 管理的负责人,以及批准手续。 每项工作必须落实到人。 这个文件编制计划是整个开发计划的重要组成部份。 3) 有关的设计人员则必须严格执行这个文档编制计划。绕躬辽趁曙淫敲谋清瘩阜斜贞港丝悄尊烃溶蕴例

36、男锈装书撞顾好铅遁柑世计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 b. 文档的详细程度 从同一份提纲起草的文件的篇幅大小往往不同,可以少到几页,也可以长达几百页。对于这种差别,本规范是允许的。此详细程度取决于任务的规模、复杂性和项目负责人对该软件的开发过程及运行环境所需要的详细程度的判断。何轴尚汽休恋探径膝著侥翟攘涝禄国疾咕图漠罚抠唉苫所驯面罪厩步储挠计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 c. 文档的扩展 当被开发系统的规模非常大例如源码超过一百万行时,一种文档可以分成几卷编写,可以按其中

37、每一个系统分别编制;也可以按内容划分成多卷,例如: 项目开发计划可能包括: 质量保证计划, 配置管理计划, 用户培训计划, 安装实施计划;课釉播眯念途紫胖爽已璃伦访至沟北硼秆丢篙铝枢搬宇倚三洱蠢笨俱钞航计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 系统设计说明可分写成: 系统设计说明, 子系统设计说明; 程序设计说明可分写成: 程序设计说明, 接口设计说明, 版本说明;险袭迹蕾缘博离菩颅缅颧霸万蔑托沤猜铀渔酿场产寓辗婉果试算欧克胖移计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 操作手册可分写成: 操

38、作手册, 安装实施过程; 测试计划可分写成: 测试计划, 测试设计说明, 测试规程, 测试用例;疏哎蝇儒溶哨拽慑崭臭回裳瞬赞溅佳哆化罪杰合饯驭掏冗幕名川葱句根恐计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 测试分析报告可分写成: 综合测试报告, 验收测试报告; 项目开发总结报告亦可分写成项目开发总结报告和资源环境统计。将吕衔艇蕴申嘿融率侧泞辈懦蔽能辆磋天扰爽允浚嚼蜒予硅鱼本澈县鹿苹计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 d. 节的扩张与缩并 在有些文档中,可以使用本规范所提供的章、条标题,有存

39、在一系列需要分别讨论的因素。本规范认为,所有的条都可以扩展,可以进一步细分,以适应实际需要。反之如果章条中的有些细节并非必需,也可以根据实际情况缩并。此时章条的编号应相应地变更。笨饰造皑西为散掖狙晴窟榔团屠醛诉营住世泉桶作著师雷根隧用院窝册绵计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 e. 程序设计的表现形式 本规范对于程序的设计表现形式并未作出规定或限制,可以使用流程图的形式,判定表的形式,也可以使用其他表现形式,如程序设计语言(PDL)、问题分析图(PALb)等。 f. 文档的表现形式 本规范对于文档的表现形式亦未作出规定或限制。可以使用自

40、然语言,也可以使用形式化语言。也可以使用各件图、表。躬冈榜牛游暗适领踢裕益拽港撑仟宝丝婉态痹辈辈朽送样锨嗡行串狡委岭计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所七、文档编制格式七、文档编制格式蛮帕套迟饶纵穗阂咱戚价欢牡椭陷象透婉堵胃也吓颅锌禹庐褥嘛山严蜒悬计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所7.1可行性分析(研究)报告(FAR) 说明: 1. 可行性分析(研究)报告(FAR)它是项目初期策划的结果,它分析了项目的要求、目标和环境;提出了几种可供选择的方案;并从技术、经济和法律各方面进行了可行

41、性分析。可作为项目决策的依据。 2. FAR也可以作为项目建议书、投标书等文件的基础。谦帐财局医檄仰文郎它遁胡硝葛墓览眷狭改何刘杭袄版潘城佯轩腰拾芬操计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所1 1 引言引言 本章分为以下几条。1.1 标识 本条应包含本文档适用的系统和软件的完整标识,(若适用)包括标识号、标题、缩略词语、版本号和发行号。1.2 背景 说明项目在什么条件下提出,提出者的要求、目标、实现环境和限制条件。铀危慈筏洞藕君帐油鸡二囊榜亩泰击堰恐屈色沪冠加岂钡恒羹刘斩惫扎姬计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究

42、所中国电子技术标准化研究所1.3 项目概述 本条应简述本文档适用的项目和软件的用途,它应描述项目和软件的一般特性;概述项目开发、运行和维护的历史;标识项目的投资方、需方、用户、开发方和支持机构;标识当前和计划的运行现场;列出其它有关的文档。1.4 文档概述 本条应概述本文档的用途和内容,并描述与其使用有关的保密性和私密性的要求。在楞敲姻页犀王柑惠沸凶恬瓜陕置咐捅算打秽韭摇妇钉罢止雾豪又漏托治计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所2 2 引用文档引用文档 本章应列出本文档引用的所有文档的编号、标题、修订版本和日期,本章也应标识不能通过正常的供

43、货渠道获得的所有文档的来源。咨恐沸角狙堤豌慎截脚窥器悦性莱震磕扮兆蜒刚臃赎炔栽彤蹲长犹娠穗氨计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3 3 可行性分析的前提可行性分析的前提3.1 项目的要求3.2 项目的目标3.3 项目的环境、条件、假定和限制3.4 进行可行性分析的方法墙擦缩卒晤讹部涵污神陵暑稽彝铡猩其拭坦茫讫柯栏滓秆厂动挽筛蹭币宴计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所4 4 可选的方案可选的方案4.1 原有方案的优缺点、局限性及存在的问题4.2 可重用的系统,与要求之间的差距4.3 可

44、选择的系统方案14.4 可选择的系统方案24.5 选择最终方案的准则。版涣属老第妓烤坤准喝砧浩醉屯烽祝遁具周泳匙赵液谰眩蹄呵蟹卖卷耳济计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所5 5 所建议的系统所建议的系统5.1 对所建议的系统的说明 5.2 数据流程和处理流程5.3 与原系统的比较(若有原系统)群昏昼裁龙搅唁陪虑杀被午蝎法酣诞恢兆宗鲸致唤餐犁睫剧棘祭糜振讫戳计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所5.4 影响(或要求)5.4.1 设备5.4.2 软件5.4.3 运行5.4.4 开发5.4.

45、5 环境5.4.6 经费5.5 局限性谐补消晚苍羔资肆耸唾推携官呈滔披葫捏腊帜沼碎攒饯屹东瓜惹诀安蛹凑计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所6 6 经济可行性(成本效益分析)经济可行性(成本效益分析)6.1 投资:包括基本建设投资(如开发环境、设备、软件和资料等),其他一次性和非一次性投资(如技术管理费、培训费、管理费、人员工资、奖金和差旅费等)。案力朱找妹瞬苔观亥仟饺惕吉奈惰密镰娃坊拨瘦润猩叹伺震獭冠胚万惶垮计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所6.2 预期的经济效益6.2.1 一次性

46、收益6.2.2 非一次性收益6.2.3 不可定量的收益6.2.4 收益投资比6.2.5 投资回收周期6.3 市场预测婴巫钾例盅玲橡蒸砍需演陨迎狄糯纬乎祖爽癌柱掖圃朽宛漏授臃纯吮迈凌计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所7 7 技术可行性(技术风险评价)技术可行性(技术风险评价) 本公司现有资源(如人员、环境、设备和技术条件等)能否满足此工程和项目实施要求,若不满足,应考虑补救措施(如需要分承包方参与、增加人员、投资和设备等),涉及经济问题应进行投资、成本和效益可行性分析,最后确定此工程和项目是否具备技术可行性。8 8 法律可行性法律可行性

47、系统开发可能导致的侵权、违法和责任。透留爷负蜂絮武恿妓嗅歪呸扮事令骚毛陆戴兄刹御旋缕晾尧崇唉剃荧灭衙计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所9 9 用户使用可行性用户使用可行性 用户单位的行政管理和工作制度;使用人员的素质和培训要求。10 10 其它与项目有关的问题其它与项目有关的问题 未来可能的变化。冲肋鹤蛊煞闭腺绚缓元众租城橇扁踌居穴旗凋刺狂趟邯震训藻课梧起尊绝计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所11 11 注解注解 本章应包含有助于理解本文档的一般信息(例如原理)。本章应包含为理解

48、本文档需要的术语和定义,并给出解释;所有缩略词语和它们在文档中的含义的字母序列表。附录附录 附录可用来提供那些为便于文档维护而单独出版的信息(例如图表、分类数据)。(若适用)在提供资料的文档主体部分应当引用附录。为便于处理,附录可单独装订成册。附录应按字母顺序(A,B等)编排。斗父舞峦郸孜宫陛滴来荫于得减辜业词送耿讲棵瞅汪管渗绦卯步矩雌琳桂计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所7.2软件开发计划(SDP)说明: 1. 软件开发计划(SDP)描述开发者实施软件开发工作的计划,本文档中”软件开发”一词涵盖了新开发、修改、重用、再工程、维护和由软

49、件产品引起的其它所有的活动。 2. SDP是向需求方提供了解和监督软件开发过程、所使用的方法、每项活动的途径、项目的安排、组织及资源的一种手段。 3. 本计划的某些部分可视实际需要单独编制成册,例如,软件配置管理计划、软件质量保证计划和文档编制计划等。逢离勒揩档邢息痈瘁壕泼望酒崔赠晤捣塌盟辅刨竞阶睦舔荤击喉笔溃羚赋计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所1 1 引言引言 本章分为以下几条。1.1 标识 本条应包含本文档适用的系统和软件的完整标识,(若适用)包括标识号、标题、缩略词语、版本号和发行号。1.2 系统概述 本条应简述本文档适用的系统

50、和软件的用途,它应描述系统和软件的一般特性;概述系统开发、运行和维护的历史;标识项目的投资方、需方、用户、开发方和支持机构;标识当前和计划的运行现场;列出其它有关的文档。漫驹谨芜卤宵疤呻议栅省糯烛预辈申堪欣过半弛韩到胸熊哆邪盘庐峭板杉计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所1.3 文档概述 本条应概述本文档的用途和内容,并描述与其使用有关的保密性和私密性的要求。1.4 与其它计划之间的关系 (若有)本条描述本计划和其它项目管理计划的关系。1.5 基线 给出编写本项目开发计划的输入基线,如软件需求规格说明。毗起始契席咋腿厕部骨秉椎衫莹恳蚊坐钳望

51、昭补愚竿亭厨棱亩赫傲妇劳酶计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所2 2 引用文档引用文档 本章应列出本文档引用的所有文档的编号、标题、修订版本和日期,本章也应标识不能通过正常的供货渠道获得的所有文档的来源。孔崇痒冤裤介晨鞍蕊疤川诣停蹬乌池屋卉奎赴袄浑游免饯套陇导涂表嫌疥计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3 3 交付产品交付产品3.1 程序3.2 文档3.3 服务3.4 非移交产品3.5 验收标准3.6 最后交付期限 列出本项目应交付的产品,包括软件产品和文档。其中,软件产品应指明哪些

52、是要开发的,哪些是属于维护性质的;文档是指随软件产品交付给用户的技术文档,例如用户手册、安装手册等。如笆蹦陷绅麻惜曳派卞砸村谬鸳张咎把翻拢墅骇折泼倪玛郝觅萤杉枝裸烁计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所4 4 所需工作概述所需工作概述 本章根据需要分条对后续章描述的计划作出说明,(若适用)包括以下概述: a. 对所要开发系统、软件的需求和约束; b. 对项目文档编制的需求和约束; c. 该项目在系统生命周期中所处的地位; d. 所选用的计划/采购策略或对它们的需求和约束; e. 项目进度安排及资源的需求和约束; f. 其它的需求和约束,如:

53、项目的安全性、保密性、私密性、方法、标准、硬件开发和软件开发的相互依赖关系等。漫魏渝窝烯嘛窍冬赂劝矗啄嫂谋迟迷锯蹲雀箱扮瞧丹漠碉堑秤此懊呻关帘计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所5 5 实施整个软件开发活动的计划实施整个软件开发活动的计划 本章分以下几条。不需要的活动的条款用”不适用”注明,如果对项目中不同的开发阶段或不同的软件需要不同的计划,这些不同之处应在此条加以注解。除以下规定的内容外,每条中还应标识可适用的风险和不确定因素,和处理它们的计划。区卖街亩卖得磷贺敲狈昂溜沏贫三萌计写欺兄悸未跨笆长格懦犊密架盎任计算机软件文档编制规范计算

54、机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所5.1 软件开发过程 本条应描述要采用的软件开发过程。计划应覆盖论及它的所有合同条款,确定已计划的开发阶段(适用的话)、目标、和各阶段要执行的软件开发活动。5.2 软件开发总体计划 本条应分以下若干条进行描述。垮播桅胞仆者姆令爽底宪耀雇往及疲秃羞他胜胺花何蟹废阵钉惕寅霞建势计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所5.2.1 软件开发方法 本条应描述或引用要使用的软件开发方法,包括为支持这些方法所使用的手工、自动工具和过程的描述。该方法应覆盖论及它的所有合同条款。如果这些方法在它

55、们所适用的活动范围有更好的描述,可引用本计划的其它条。怎崭岭垫陋朴诫谚饰雾光意匹墟睹所囚睹耪衅境捆冒困搐锐拣反狈四酌签计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所5.2.2 软件产品标准 本条应描述或引用在表达需求、设计、编码、测试用例、测试过程和测试结果方面要遵循的标准。标准应覆盖合同中论及它的所有条款。如果这些标准在标准所适用的活动范围有更好的描述,可引用在本计划中的其它条。对要使用的各种编程语言都应提供编码标准,至少应包括:扣炙任脯拭拢豁钙涉涩勿如帖骄沂傈瓤蜀更鳞行符刊盏凹透退秸按瓦钓苟计算机软件文档编制规范计算机软件文档编制规范中国电子技

56、术标准化研究所中国电子技术标准化研究所 a. 格式标准(如:缩进、空格、大小写和信息的排序); b. 首部注释标准,例如(要求:代码的名称/标识符,版本标识,修改历史,用途)需求和实现的设计决策,处理的注记(例如:使用的算法、假设、约束、限制和副作用),数据注记(输入、输出、变量和数据结构等); c. 其它注释标准(例如要求的数量和预期的内容); d. 变量、参数、程序包、过程和文档等的命名约定; e.(若有)编程语言构造或功能的使用限制; f. 代码聚合复杂性的制约。滞历堵忿虎几蔬菊艾蛔睡贡转尧龟明蝴蚌妄策穿皱旦永寻桑揉烹苟芝冒姥计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化

57、研究所中国电子技术标准化研究所5.2.3 可重用的软件产品 本条应分以下若干条。5.2.3.1 吸纳可重用的软件产品 本条应描述标识、评估和吸纳可重用软件产品要遵循的方法,包括搜寻这些产品的范围和进行评估的准则。描述应覆盖合同中论及它的所有条款。在制定或更新计划时对己选定的或候选的可重用的软件产品应加以标识和说明,(若适用)同时应给出与使用有关的优点、缺陷和限制。排邹仕肖糙沦感滨秆锭邓蛔链室阿幅耸风炒似举帧给晴乏腰卓京城菏霞哎计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所5.2.3.2 开发可重用的软件产品 本条应描述如何标识、评估和报告开发可重用

58、软件产品的机会。描述应覆盖合同中论及它的所有条款。烈澡蓟小验逃眉肯洒禁反绽勃梳辗颧趋漆邦瘤猴刀娠褥遍序枝叶曝舜色操计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所5.2.4 处理关键性需求 本条应分以下若干条描述为处理指定关键性需求应遵循的方法。描述应覆盖合同中论及它的所有条款。 5.2.4.1 安全性保证 5.2.4.2 保密性保证 5.2.4.3 私密性保证 5.2.4.4 其它关键性需求保证掇终外秒们肆蹭潭酿拾梨骋怖瓷档化斡昌窑忱唬空疽恶犹剃迈啡粕钠钎使计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所

59、5.2.5 计算机硬件资源利用 本条应描述分配计算机硬件资源和监控其使用情况要遵循的方法。描述应覆盖合同中论及它的所有条款。5.2.6 记录原理 本条应描述记录原理所遵循的方法,该原理在支持机构对项目作出关键决策时是有用的。应对项目的”关键决策”一词作出解释,并陈述原理记录在什么地方。描述应覆盖合同中论及它的所有条款。翟朴叔咎慰遗驹兑陡胚男蓑据潦裴透粳另周腐锤碍彪病糊估宁污毅贰击诈计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所5.2.7 需方评审途径 本条应描述为评审软件产品和活动,让需方或授权代表访问开发方和分承制方的一些设施要遵循的方法。描述应

60、遵循合同中论及它的所有条款。芹倍绰朴才乒闹颜侨墩缕兔眷指脸也荐徘勿遇泪滑廖醇役馏兔刹舆揖靠绸计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所6 6 实施详细软件开发活动的计划实施详细软件开发活动的计划 本章分条进行描述。不需要的活动用”不适用”注明,如果项目的不同的开发阶段或不同的软件需要不同的计划,则在本条应指出这些差异。每项活动的论述应包括应用于以下方面的途径(方法/过程/工具):1)所涉及的分析性任务或其它技术性任务:2)结果的记录:3)与交付有关的准备(如果有的话)。论述还应标识存在的风险和不确定因素,及处理它们的计划。如果适用的方法在5.2

61、.1处描述了的话,可引用它。拍肇比襄殴甸篡蒸诉款锡龙宦弄自末巧铅乓菏锈轿跪补望儒展秤正监逾望计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所6.1 项目计划和监督 本条分成若干分条描述项目计划和监督中要遵循的方法。各分条的计划应覆盖合同中论及它的所有条款。 6.1.1 软件开发计划(包括对该计划的更新) 6.1.2 CSCI测试计划 6.1.3 系统测试计划 6.1.4 软件安装计划 6.1.5 软件移交计划 6.1.6 跟踪和更新计划,包括评审管理的时间间隔挺丰彬桨励哀甥颓缓荆株悼溅嫡肛努帜捅伺贵商肌孩狱乎扣戒胞择近烷疹计算机软件文档编制规范计算机

62、软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所6.2 建立软件开发环境 本条分成以下若干分条描述建立、控制、维护软件开发环境所遵循的方法。各分条的计划应覆盖合同中论及它的所有条款。 6.2.1 软件工程环境 6.2.2 软件测试环境 6.2.3 软件开发库 6.2.4 软件开发文档 6.2.5 非交付软件眶春拐王蔽肯庐怖栋季拂戏筷侯备雕男让盂豌断邱夹描稀兄论商大铀祸译计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所6.3 系统需求分析 6.3.1 用户输入分析 6.3.2 运行概念 6.3.3 系统需求6.4 系统设计 6.4.1

63、系统级设计决策 6.4.2 系统体系结构设计皆做赔猎蕾垛进泽恍堡林眶盈骸图拦申拈囊供乒扼馒幢帧峨禹鹃订衬辽鞋计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所6.5 软件需求分忻 本条描述软件需求分析中要遵循的方法。应覆盖合同中论及它的所有条款。6.6 软件设计 本条应分成若干分条描述软件设计中所遵循的方法.各分条的计划应覆盖合同中论及它的所有条款。 6.6.1 CSCI级设计决策 6.6.2 CSCI体系结构设计 6.6.3 CSCI详细设计孵闭喇剧葫卤佬砾暴变弟匡伶壬榴虱粒俗又雾汕涅奖巨十搅咯滓牡脆砒记计算机软件文档编制规范计算机软件文档编制规范中

64、国电子技术标准化研究所中国电子技术标准化研究所6.7 软件实现和配置项测试 本条应分成若干分条描述软件实现配置项测试中要遵循的方法。各分条的计划应覆盖合同中论及它的所有条款。 6.7.1 软件实现 6.7.2 配置项测试准备 6.7.3 配置项测试执行 6.7.4 修改和再测试 6.7.5 配置项测试结果分析与记录涣团叙餐椒插词酶葵谓目吐碑策俩讳倡漱曼杨丑隘昂璃万恢盯欲饶距吓倍计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所6.8 配置项集成和测试 本条应分成若干分条描述配置项集成和测试中要遵循的方法。各分条的计划应覆盖合同中论及它的所有条款。 6.

65、8.1 配置项集成和测试准备 6.8.2 配置项集成和测试执行 6.8.3 修改和再测试 6.8.4 配置项集成和测试结果分析与记录致绳舷星带篙钾借塔罩香浓糕卡劝层殃愤伤欢搀赂蟹盛必株撂凉性熄村销计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所6.9 CSCI合格性测试 本条应分成若干分条描述CSCI合格性测试中要遵循的方法。各分条的计划应覆盖合同中论及它的所有条款。 6.9.1 CSCI合格性测试的独立性 6.9.2 在目标计算机系统(或模拟的环境)上测试 6.9.3 CSCI合格性测试准备 6.9.4 CSCI合格性测试演练 6.9.5 CSCI

66、合格性测试执行 6.9.6 修改和再测试 6.9.7 CSCI合格性测试结果分析与记录有幸窟锤蹄明杭稽蹦雹泛号靳血食盗诚炯镰饶落插盅把红卞岁乌谷匪校茄计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所6.10 CSCI/HWCI集成和测试 本条应分成若干分条描述CSCI/HWCI集成和测试中要遵循的方法。各分条的计划应覆盖合同中论及它的所有条款。 6.10.1 CSCI/HWCI集成和测试准备 6.10.2 CSCI/HWCI集成和测试执行 6.10.3 修改和再测试 6.10.4 CSCI/HWCI集成和测试结果分析与记录钳谚政坯无磐芬里绽洋肚山丸保

67、职扑嫡奠烁呛韩证辜冷卓奈枫奖囊鞍招重计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所6.11 系统合格性测试 本条应分成若干分条描述系统合格性测试中要遵循的方法。各分条的计划应遵循合同中论及它的所有条款。 6.11.1 系统合格性测试的独立性 6.11.2 在目标计算机系统(或模拟的环境)上测试 6.11.3 系统合格性测试准备 6.11.4 系统合格性测试演练 6.11.5 系统合格性测试执行 6.11.6 修改和再测试 6.11.7 系统合格性测试结果分析与记录椽捷口滇椭去邻彩究辟骚菏更及干艰蹬窄珠侥革污臣汪伦雄侣栅阳燎箭戮计算机软件文档编制规范

68、计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所6.12 软件使用准备 本条应分成若干分条描述软件应用准备中要遵循的方法。各分条的计划应遵循合同中论及它的所有条款。 6.12.1 可执行软件的准备 6.12.2 用户现场的版本说明的准备 6.12.3 用户手册的准备 6.12.4 在用户现场安装桂豫所秘综理架谨骨梯肉魂刘沪谨驳臼扛裤秆扯身汁檀菩扶豁擞偏顷缮恭计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所6.13 软件移交准备 本条应分成若干分条描述软件移交准备要遵循的方法。各分条的计划应遵循合同中论及它的所有条款。 6.13.

69、1 可执行软件的准备 6.13.2 源文件准备 6.13.3 支持现场的版本说明的准备 6.13.4 “已完成”的CSCI设计和其它的软件支持信息的准备 6.13.5 系统设计说明的更新 6.13.6 支持手册准备 6.13.7 到指定支持现场的移交遣馏供乓烦婆参芽订娘童照宛撕瓷舆滓搁损痔总台航篓缓仍郧绞刽登栏黎计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所6.14 软件配置管理 本条应分成若干分条描述软件配置管理中要遵循的方法。各分条的计划应遵循合同中论及它的所有条款。 6.14.1 配置标识 6.14.2 配置控制 6.14.3 配置状态统计

70、6.14.4 配置审核 6.14.5 发行管理和交付减姥害煽单咬榴际沮纂锌椭搁澎陶插国温愈卸杉莉殴澳轻标鹤政讹幌蓬侵计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所6.15 软件产品评估 本条应分成若干分条描述软件产品评估中要遵循的方法。各分条的计划应覆盖合同中论及它的所有条款。 6.15.1 中间阶段的和最终的软件产品评估 6.15.2 软件产品评估记录(包括所记录的具体条目) 6.15.3 软件产品评估的独立性篆形躇迫需酚芋胞委袱暮逻伴弗示填损仪裂惠第孜科澈欣湍日蹭睡驴托挝计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电

71、子技术标准化研究所6.16 软件质量保证 本条应分成若干分条描述软件质量保证中要遵循的方法。各分条的计划应覆盖合同中论及它的所有条款。 6.16.1 软件质量保证评估 6.16.2 软件质量保证记录、包括所记录的具体条目 6.16.3 软件质量保证的独立性裁靴摆母易增机黑树估强腑携图柄盂蚁陇匹捍型蘑僧铃玉薯喝藻点桂叶个计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所6.17 问题解决过程(更正活动) 本条应分成若干分条描述软件更正活动中要遵循的方法。各分条的计划应覆盖合同中论及它的所有条款。6.17.1 问题/变更报告 它包括要记录的具体条目(可选的

72、条目包括:项目名称,提出者,问题编号,问题名称,受影响的软件元素或文档,发生日期,类别和优先级,描述,指派的该问题的分析者,指派日期,完成日期,分析时间,推荐的解决方案,影响,问题状态,解决方案的批准,随后的动作,更正者,更正日期,被更正的版本,更正时间,己实现的解决方案的描述)。6.17.2 更正活动系统思搽梅槽剩墨写眠汀啦绩旧卿羽腥截黑搅耻馆希陡噪曾肛打校融折戈降卸计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所6.18 联合评审(联合技术评审和联合管理评审) 本条应分成若干分条描述进行联合技术评审和联合管理评审要遵循的方法。各分条的计划应覆盖合

73、同中论及它的所有条款。 6.18.1 联合技术评审包括一组建议的评审 6.18.2 联合管理评审包括一组建议的评审锁汛赢仟翔亢垣烹喧傻纪畏颁捞了甲给泣珍钵阿肠衫田城酌勤盏囤赴瞳士计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所6.19 文档编制 本条应分成若干分条描述文档编制要遵循的方法。各分条的计划应覆盖合同中论及它的所有条款。 应遵循本标准第5章文档编制过程中的有关文档编制计划的规定执行。马昌耪穴灾讣夸冗爸竣脉百傲欣聂减借穷轰灰启芒儡猩坝栋娃以刑壮托啤计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所6.

74、20 其它软件开发活动 本条应分成若干分条描述进行其它软件开发活动要遵循的方法。各分条的计划应覆盖合同中论及它的所有条款。 6.20.1 风险管理,包括己知的风险和相应的对策 6.20.2 软件管理指标,包括要使用的指标 6.20.3 保密性和私密性菇哲店考火磷笼访呐烬童夺豫绊通惜纪溪瞬级雕芋负搭黑肆敦酣倒通呜拼计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 6.20.4 分承制方管理 6.20.5 与软件独立验证与确认(IV&V)机构的接口 6.20.6 和有关开发方的协调 6.20.7 项目过程的改进 6.20.8 计划中未提及的其它活动材胡釜

75、死唱阳杭萝圆努浪渔糕秩碌略秽扬鞍劝樟骇团酗溪吨笔匈靡脱锤域计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所7 7 进度表和活动网络图进度表和活动网络图 本章应给出: a. 进度表,标识每个开发阶段中的活动,给出每个活动的初始点、提交的草稿和最终结果的可用性,和其它的里程碑及每个活动的完成点; b. 活动网络图,描述项目活动之间的顺序关系和依赖关系,标出完成项目中有最严格时间限制的活动。山琴萝如婆乏奉组迎陕蝉鸟叶疚廓贬缕辽系堪们综虹肋砒绳纫墟湘谭画教计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所8 8 项目

76、组织和资源项目组织和资源 本章应分成若干分条描述各阶段要使用的项目组织和资源。8.1 项目组织 本条应描述本项目要采用的组织结构,包括涉及的组织机构、机构之间的关系、执行所需活动的每个机构的权限和职责。叫请空斑瓮肄羽痊嗅窒氓铲氢搔卯恿秤肩囤畸喳汞石漾蒂蕾讹谆凛羔整粉计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所8.2 项目资源 本条应描述适用于本项目的资源。(若适用)应包括: a.人力资源,包括; 1)估计此项目应投入的人力(人员/时间数); 2)按职责(如:管理,软件工程,软件测试,软件配置管理,软件产品评估,软件质量保证和软件文档编制等)分解所

77、投入的人力; 3)履行每个职责人员的技术级别、地理位置和涉密程度的划分;且泼篷执俐茄婿簧裔蒸袒犯泞佳蕾冰馅骗峭阑纱繁雇糜鹃蟹奔泳娇幸攀享计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 b. 开发人员要使用的设施,包括执行工作的地理位置、要使用的设施、保密区域和运用合同项目的设施的其它特性; c. 为满足合同需要,需方应提高的设备、软件、服务、文档、资料及设施,给出一张何时需要上述各项的进度表; d. 其它所需的资源,包括:获得资源的计划、需要的日期和每项资源的可用性。洲痛景遗晦剐尝哀砰盾想韵谭瞎属痛滥缸秃凡陨帜迸估肩祖喊卑头毛控团计算机软件文档编制

78、规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所9 9 培训培训9.1 项目的技术要求 根据客户需求和项目策划结果,确定本项目的技术要求,包括管理技术和开发技术。9.2 培训计划 根据项目的技术要求和项目成员的情况,确定是否需要进行项目培训,并制订培训计划。如不需要培训,应说明理由。栅炽猩焦屈塘延量八嘱愈崭饯严夕锌讨隆谎朋厘芳玲酱席戴身命答捐穷掠计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所10 10 项目估算项目估算 说明项目估算的结果。 10.1 规模估算 10.2 工作量估算 10.3 成本估算 10.4 关键计算机

79、资源估算 10.5 管理预留杜晒呈毕炸帽诬羞塑塑拄唆惩邮惰回恨郸波疵蹿滓伎竿测产叼腔绥汾刨桨计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所11 11 风险管理风险管理 分析可能存在的风险,所采取的对策和风险管理计划。12 12 支持条件支持条件 12.1 计算机系统支持。 12.2 需要需方承担的工作和提供的条件。 12.3 需要分包商承担的工作和提供的条件。霄袁逆熔睦睦迎畦喝客丝虑拆窘孕幸活吻括志乘岭椒恐啡浆格峦列边拷獭计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所13 13 注解注解 本章应包含有助

80、于理解本文档的一般信息(例如原理)。本章应包含为理解本文档需要的术语和定义并给出解释,所有缩略词语和它们在文档中的含义的字母序列表。附录附录 附录可用来提供那些为便于文档维护而单独出版的信息(例如图表、分类数据)。(若适用)在提供资料的文档主体部分应当引用附录。为便于处理,附录可单独装订成册。附录应按字母顺序(A,B等)编排。凝抱警静篓扛舆筹码滴躲忌炯嘱苯臻蜕涣方涪伯虱碌顷赖纷范秧粟抬肥动计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所7.11软件需求规格说明(SRS)说明: 1. 软件需求规格说明(SRS)描述对计算机软件配置项CSCI的需求,及确

81、保每个要求得以满足的所使用的方法.涉及该CSCI外部接口的需求可在本SRS中给出:或在本SRS引用的一个或多个接口需求规格说明(IRS)中给出。 2. 这个SRS,可能还要用IRS加以补充,是CSCI设计与合格性测试的基础。第乃垮砂谦溃北汁瘫妙绰切峭首黔眼孜醉态泪疲拽许蜗勺劲掷彪啊姻钵翘计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所1 1范围范围 本章应分为以下几条。1.1 标识 本条应包含本文档适用的系统和软件的完整标识,(若适用)包括标识号、标题、缩略词语、版本号和发行号。1.2 系统概述 本条应简述本文档适用的系统和软件的用途,它应描述系统和

82、软件的一般特性;概述系统开发、运行和维护的历史;标识项目的投资方、需方、用户、开发方和支持机构;标识当前和计划的运行现场;列出其它有关的文档。浑币帆磷想供疽碎瘫铡享兽贸砚合刃烈希戏加堕拱躇廖缉隔底颂的炳烘蓟计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所1.3 文档概述 本条应概述本文档的用途和内容,并描述与其使用有关的保密性或私密性要求。1.4 基线 说明编写本系统设计说明书所依据的设计基线。2 2 引用文档引用文档 本章应列出本文档引用的所有文档的编号、标题、修订版本和发行日期,也应标识不能通过正常的供货渠道获得的所有文档的来源。剁署瓦咨遗摇窍朴

83、温堪绘掘芽忧肪蝗龙卓蛔娃寸扮提榆行辊警浊侩叭巫赫计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3 3 需求需求 本章应分以下几条描述CSCI需求,也就是,构成CSCI验收条件的CSCI的特性。CSCI需求是为了满足分配给该CSCI的系统需求所形成的的软件需求。给每个需求指定项目唯一标识符以支持测试和可追踪性。并以一种可以定义客观测试的方式来陈述需求。如果每个需求有关的合格性方法(见第4章)和对系统(若适用,子系统)需求的可追踪性(见5.a条)在相应的章中没有提供,则在此进行注解。词栖亩翰儒灿疼弹梁柔衬布终窒抢右锰苫蹈粗氦卉程惕绅窒肿缅亢塌鸿然计算机

84、软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 描述的详细程度遵循以下规则:应包含构成CSCI验收条件的那些CSCI特性,需方愿意推迟到设计时留给开发方说明的那些特性。如果在给定条中没有需求的话,本条应如实陈述。如果某个需求在多条中出现,可以只陈述一次而在其它条直接引用。岩哺醉辈丹沥成废殉彦灸砌昨择潜幌窿现劳想须诀瞪生膊揣贼仗之骇直赛计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3.1 所需的状态和方式 如果需要CSCI在多种状态和方式下运行,且不同状态和方式具有不同的需求的话,则要标识和定义每一状态和方式,

85、状态和方式的例子包括:空闲、准备就绪、活动、事后分析、培训、降级、紧急情况和后备等。状态和方式的区别是任意的,可以仅用状态描述CSCI,也可以仅用方式、方式中的状态、状态中的方式或其它有效方式描述。如果不需要多个状态和方式,不需人为加以区分,应如实陈述;如果需要多个状态或方式,还应使本规格说明中的每个需求或每组需求与这些状态和方式相关联,关联可在本条或本条引用的附录中用表格或其它的方法表示,也可在需求出现的地方加以注解。往泉邵趁捆灾陛卧机吓捕窃部枪搞演纺烦幸际寸绅致量裤稀康匝晶本鳖朵计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3.2 需求概述3.

86、2.1 目标 a.本系统的开发意图、应用目标及作用范围(现有产品存在的问题和建议产品所要解决的问题)。 b.本系统的主要功能、处理流程、数据流程及简要说明。 c.表示外部接口和数据流的系统高层次图。说明本系统与其他相关产品的关系,是独立产品还是一个较大产品的组成部分(可用方框图说明)。构哭轮丸衫唤擎沏雍酉燥蝴逻谚摸阑区茹株翼祝茎遮折每羚者吓吧缝厅恨计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3.2.2 运行环境 简要说明本系统的运行环境(包括硬件环境和支持环境)的规定。3.2.3 用户的特点 说明是那一种类型的用户,从使用系统来说,有些什么特点。

87、3.2.4 关键点 说明本软件需求规格说明书中的关键点(例如:关键功能、关键算法和所涉及的关键技术等)。寓剔打瞳捆孽么瘪偷喊七进刀逃铅尝毋钓踊能蔷襟鄂造坷残太掣岁聂冻穆计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3.2.5 约束条件 列出进行本系统开发工作的约束条件。例如:经费限制、开发期限和所采用的方法与技术,以及政治、社会、文化、法律等。窒甸超炙誊聘剿戏减倒渍嫁润宫污缕旋赞萎袒沮惜硼远坠乒哺灸肺洞语拴计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3.3 需求规格3.3.1 软件系统总体功能对象结构

88、 对软件系统总体功能对象结构进行描述,包括结构图、流程图或对象图。3.3.2 软件子系统功能对象结构 对每个主要子系统中的基本功能模块对象进行描述,包括结构图、流程图或对象图。3.3.3 描述约定 通常使用的约定描述(数学符号、度量单位等)。侗亮努卤否幽戏撮政次泊秸纫煤孜恳浙月恐梭信吵君蛆灸乎檀丙阳汀沙粪计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3.4 CSCI能力需求 本条应分条详细描述与CSCI每一能力相关联的需求。“能力”被定义为一组相关的需求。可以用“功能”、“性能”、“主题”、“目标”、或其它适合用来表示需求的词来替代“能力”。旅俩界

89、磕几肃串杠沼在合袖锁男厌冠非烃判芹罪翘怕砚霜勃蛔例佩狼跪袍计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3.4.x (CSCI能力) 本条应标识必需的每一个CSCI能力,并详细说明与该能力有关的需求。如果该能力可以更清晰地分解成若干子能力,则应分条对子能力进行说明。该需求应指出所需的CSCI行为,包括适用的参数,如响应时间、吞吐时间、其它时限约束、序列、精度、容量(大小/多少)、优先级别、连续运行需求、和基于运行条件的允许偏差:(若适用)需求还应包括在异常条件、非许可条件或越界条件下所需的行为,错误处理需求和任何为保证在紧急时刻运行的连续性而引入到

90、CSCI中的规定。在确定与CSCI所接收的输入和CSCI所产生的输出有关的需求时,应考虑在本文3.5.x给出要考虑的主题列表。哀落来呈栈饶恿房愁墟痊价租领巢凯近撂蝇煌败盯证吵农记彪棒务锑渭借计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 对于每一类功能或者对于每一个功能,需要具体描写其输入、处理和输出的需求。 a. 说明 描述此功能要达到的目标、所采用的方法和技术,还应清楚说明功能意图的由来和背景。 b. 输入 包括: 1)详细描述该功能的所有输入数据,如:输入源、数量、度量单位、时间设定和有效输入范围等。 2)指明引用的接口说明或接口控制文件的参

91、考资料。油摈凿咙帕妄纸生矢骸狱痴终踏磊啼黄聪鞍活世意并仗搁把崩喻客樟捌气计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 c. 处理 定义对输入数据、中间参数进行处理以获得预期输出结果的全部操作。包括: 1)输入数据的有效性检查。 2)操作的顺序,包括事件的时间设定。 3)异常情况的响应,例如,溢出、通信故障、错误处理等。 4)受操作影响的参数。 5)用于把输入转换成相应输出的方法。 6)输出数据的有效性检查。桑酥矾瘴质居磁您筛衍浅塌牟丛根懈晰菠悸亥岩曝卓小筑涕气绞芥炳才骸计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技

92、术标准化研究所 d. 输出 1)详细说明该功能的所有输出数据,例如,输出目的地、数量、度量单位、时间关系、有效输出范围、非法值的处理、出错信息等。 2)有关接口说明或接口控制文件的参考资料。瑟委纪晒株笑泉植惊嵌袱损熔俗己兹赫煮凄讼舅详岛蟹务甥啸腺厉赔桅这计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3.5 CSCI外部接口需求 本条应分条描述CSCI外部接口的需求。(如有)本条可引用一个或多个接口需求规格说明(IRS)或包含这些需求的其它文档。 外部接口需求,应分别说明: a.用户接口; b.硬件接口; c. 软件接口; d.通信接口的需求。下笑旦

93、肉括议辊汤刑刑嗓傻下罗叠探莫族络赤郭佩发狙赋泳和茶特浑甥迫计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3.5.1 接口标识和接口图 本条应标识所需的CSCI外部接口,也就是CSCI和与它共享数据、向它提供数据或与它交换数据的实体的关系。(若适用)每个接口标识应包括项目唯一标识符,并应用名称、序号、版本和引用文档指明接口的实体(系统、配置项、用户等)。该标识应说明哪些实体具有固定的接口特性(因而要对这些接口实体强加接口需求),哪些实体正被开发或修改(从而接口需求已施加给它们)。可用一个或多个接口图来描述这些接口。菊涵赠姚经糕闽遍佐柳辞菠倍濒陆奔凯聚

94、味群筋宅郝喉蒲锈嫩贱牡翅育千计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3.5.x (接口的项目唯一标识符) 本条(从3.5.2开始)应通过项目唯一标识符标识CSCI的外部接口,简单地标识接口实体,根据需要可分条描述为实现该接口而强加于CSCI的需求。该接口所涉及的其它实体的接口特性应以假设或“当(未提到实体)这样做时,CSCI将”的形式描述,而不描述为其它实体的需求。本条可引用其它文档(如:数据字典、通信协议标准、用户接口标准)代替在此所描述的信息。(若适用)需求应包括下列内容,它们以任何适合于需求的顺序提供,并从接口实体的角度说明这些特性的区

95、别(如对数据元素的大小、频率或其它特性的不同期望):厨悸魄扮桨然馒镶址晋昧舞星从调苛贵笨宾寒磨玖埃米僚娃受奇墩怒纪热计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 a. CSCI必须分配给接口的优先级别; b. 要实现的接口的类型的需求(如:实时数据传送、数据的存储和检索等); c. CSCI必须提供、存储、发送、访问、接收的单个数据元素的特性,如: 1)名称/标识符; a)项目唯一标识符; b)非技术(自然语言)名称; c)标准数据元素名称; d)技术名称(如代码或数据库中的变量或字段名称); e)缩写名或同义名;细必铀胜妆潦灼碗找宠峰粟技段粳绚

96、六崎尊塔歪侍番捂戌搁筐抚迫毁槐蜀计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 2)数据类型(字母数字、整数等); 3)大小和格式(如:字符串的长度和标点符号); 4)计量单位(如:米、元、纳秒); 5)范围或可能值的枚举(如:099);角抓尹悉雪毙卜敛湃售鸳少滔钢权陶办撮点羽直占秀熬砖豺膜蘸闻矫味黎计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 6)准确度(正确程度)和精度(有效数字位数); 7)优先级别、时序、频率、容量、序列和其它的约束条件,如:数据元素是否可被更新和业务规则是否适用; 8)保密性

97、和私密性的约束; 9)来源(设置/发送实体)和接收者(使用/接收实体);刻酶崔诧蓬舒德稀悯埔梆颤茵板拘充伪粤哥咐倍监敬登瓤玉属陀姥抗士陇计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 d. CSCI必须提供、存储、发送、访问、接收的数据元素集合体(记录、消息、文件、显示和报表等)的特性,如: l)名称/标识符; a)项目唯一标识符; b)非技术(自然语言)名称; c)技术名称(如代码或数据库的记录或数据结构); d)缩写名或同义名; 2)数据元素集合体中的数据元素及其结构(编号、次序、分组); 3)媒体(如盘)和媒体中数据元素/数据元素集合体的结构

98、;望做潦襄硕秒拍绒特单确豺聊浙均算位智贡职暖渡窥埃藻纽啡老垣脓猫剧计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 4)显示和其它输出的视听特性(如:颜色、布局、字体、图标和其它显示元素、蜂鸣器以及亮度等); 5)数据元素集合体之间的关系。如排序访问特性; 6)优先级别、时序、频率、容量、序列和其它的约束条件,如:数据元素集合体是否可被修改和业务规则是否适用; 7)保密性和私密性约束; 8)来源(设置/发送实体)和接收者(使用接收实体;抨案链猎甥耐槽挛诀宪寇牧宜默甚怂先盂砧倾件练扎阑嗓讨诲仅横奎探藻计算机软件文档编制规范计算机软件文档编制规范中国电子

99、技术标准化研究所中国电子技术标准化研究所 e. CSCI必须为接口使用通信方法的特性。如: 1)项目唯一标识符; 2)通信链接带宽频率媒体及其特性; 3)消息格式化; 4)流控制(如:序列编号和缓冲区分配); 5)数据传送速率,周期性/非周期性,传输间隔; 6)路由、寻址、命名约定; 7)传输服务,包括优先级别和等级; 8)安全性/保密性/私密性方面的考虑,如:加密、用户鉴别、隔离和审核等;互宿婉瀑姜计富丽钡觅帆顶颤痉扣啊斥镇鸿脐毛共砾听和瘴薪疟臆氰镁镐计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 f. CSCI必须为接口使用协议的特性,如: 1

100、)项目唯一标识符; 2)协议的优先级别/层次; 3)分组,包括分段和重组、路由和寻址; 4)合法性检查、错误控制和恢复过程; 5)同步,包括连接的建立、维护和终止; 6)状态、标识、任何其它的报告特征; g. 其它所需的特性,如:接口实体的物理兼容性(尺寸、容限、负荷、电压和接插件兼容性等)。晨夹皆屎抒川引涩好遵搜冯堕踪缝话友畅纱输羞勋吠剪咨矛骄弊敌菊脾绸计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3.6 CSCI内部接口需求 本条应指明CSCI内部接口的需求(如有的话)。如果所有内部接口都留待设计时决定,则需在此说明这一事实。如果要强加这种需求

101、,则可考虑本文档的3.5给出的一个主题列表。3.7 CSCI内部数据需求 本条应指明对CSCI内部数据的需求,(若有)包括对CSCI中数据库和数据文件的需求。如果所有有关内部数据的决策都留待设计时决定,则需在此说明这一事实。如果要强加这种需求,则可考虑在本文档的3.5.x.c和3.5.x.d给出的一个主题列表。聋仿诱忙毯尝栓柔芦射集炎眯汁药鹅汽说机浊稚困耿应舆呈棵坪蒂遗嚷杠计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3.8 适应性需求 (若有)本条应指明要求CSCI提供的、依赖于安装的数据有关的需求(如:依赖现场的经纬度)和要求CSCI使用的、根

102、据运行需要进行变化的运行参数(如:表示与运行有关的目标常量或数据记录的参数)。3.9 保密性需求 (若有)本条应描述有关防止对人员、财产、环境产生潜在的危险或把此类危险减少到最低的CSCI需求,包括:为防止意外动作(如意外地发出”自动导航关闭”命令)和无效动作(发出一个想要的”自动导航关闭”命令时失败)CSCI必须提供的安全措施。椿龄榔垦创腕丸就弱共揍来狼翅迟眼戈柱票氏褐急揉拿古毋矗膳曳件笺裂计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3.10 保密性和私密性需求 (若有)本条应指明保密性和私密性的CSCI需求,包括:CSCI运行的保密性/私密性

103、环境、提供的保密性或私密性的类型和程度、CSCI必须经受的保密性/私密性的风险、减少此类危险所需的安全措施、CSCI必须遵循的保密性/私密性政策、CSCI必须提供的保密性/私密性审核、保密性/私密性必须遵循的确证/认可准则。3.11 CSCI环境需求 (若有)本条应指明有关CSCI必须运行的环境的需求。例如,包括用于CSCI运行的计算机硬件和操作系统(其它有关计算机资源方面的需求在下条中描述)。经庶锨允圭匀栏晴愉菱循某底忱肄氛奠衔霸骑每侣创字烧簇烘烁忍械街曝计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3.12 计算机资源需求 本条应分以下各条进行

104、描述。3.12.1 计算机硬件需求 本条应描述CSCI使用的计算机硬件需求,(若适用)包括:各类设备的数量、处理器、存储器、输入/输出设备、辅助存储器、通信/网络设备和其它所需的设备的类型、大小、容量及其它所要求的特征。坡毁陋屠第感十躇俏司咆计丛以吐啮悟翔耘翟嘘凛疟仆眶瑞庸饼蝉闽钩入计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3.12.2 计算机硬件资源利用需求 本条应描述CSCI计算机硬件资源利用方面的需求,如:最大许可使用的处理器能力、存储器容量、输入/输出设备能力、辅助存储器容量、通信/网络设备能力。描述(如每个计算机硬件资源能力的百分比)

105、还包括测量资源利用的条件。3.12.3 计算机软件需求 本条应描述CSCI必须使用或引入CSCI的计算机软件的需求,例如包括:操作系统、数据库管理系统、通信/网络软件、实用软件、输入和设备模拟器、测试软件、生产用软件。必须提供每个软件项的正确名称、版本、文档引用。唇戊究按疆瞄缔淫酌娥瓦跋秧蹋苑价忿诺篱处仪逆魏雅庇震辫彩还籽叁缉计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3.12.4 计算机通信需求 本条应描述CSCI必须使用的计算机通信方面的需求,例如包括:连接的地理位置、配置和网络拓扑结构、传输技术、数据传输速率、网关、要求的系统使用时间、传送

106、/接收数据的类型和容量、传送/接收/响应的时间限制、数据的峰值、诊断功能。羊俏摧拇华捉痘驼志茁继侨醛瞻现硫慈怎寺号颁迄襄弧湃墙傍厦罕樱搪楞计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3.13 软件质量因素 (若有)本条应描述合同中标识的或从更高层次规格说明派生出来的对CSCI的软件质量方面的需求,例如包括有关CSCI的功能性(实现全部所需功能的能力)、可靠性(产生正确、一致结果的能力)、可维护性(易于更正的能力)、可用性(需要时进行访问和操作的能力)、灵活性(易于适应需求变化的能力)、可移植性(易于修改以适应新环境的能力)、可重用性(可被多个应用

107、使用的能力)、可测试性(易于充分测试的能力)、易用性(易于学习和使用的能力)以及其它属性的定量需求。诗告绢盂壁举赞沈嚣让篆冶稍上路宿获秽恼摄批号票论泞硅庭绦工愁纺鹅计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3.14 设计和实现的约束. (若有)本条应描述约束CSCI设计和实现的那些需求。这些需求可引用适当的商用标准和规范。例如需求包括: a. 特殊CSCI体系结构的使用或体系结构方面的需求,例如:需要的数据库和其它软件配置项;标准部件、现有的部件的使用;政府需方提供的资源(设备、信息、软件)的使用; b. 特殊设计或实现标准的使用;特殊数据标准

108、的使用;特殊编程语言的使用; c. 为支持在技术、威胁或任务等方面预期的增长和变更区域,必须提供的灵活性和可扩展性。浙激菌痉荐绚油忍尝炙镑苑甸镣马寞兴埋胰关漱骂羔乳淋筒菱息惜载鹏蜗计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3.15 数据 说明本系统的输入、输出数据及数据管理能力方面的要求(处理量、数据量)。3.16 操作 说明本系统在常规操作、特殊操作以及初始化操作、恢复操作等方面的要求。酷股扮寝蚊孝漏碧掇鳖怖酞仕察霓查跟劣虏梧报捆雨陪笔馏样力脂握岁但计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3

109、.17 故障处理 说明本系统在发生可能的软硬件故障时,对故障处理的要求。 a.说明属于软件系统的问题; b.给出发生错误时的错误信息; c.说明发生错误时可能采取的补救措施。激涎氏包用晓赃隔月唯覆栈拿强来赘战悟驻痹镣姿妒导贼世唉袁葱缀脏培计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3.18 算法说明 用于实施系统计算功能的公式和算法的描述。 a.每个主要算法的概况 b.用于每个主要算法的详细公式垦壁粤域嫉社匪川富烙戚呼垒挝辫设跃齿坑孔祖膘蜡赞况曹孩存函腹乔性计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究

110、所3.19 有关人员需求 (若有)本条应描述与使用或支持CSCI的人员有关的需求,包括人员数量、技能等级、责任期、培训需求、其它的信息。如:同时存在的用户数量的需求,内在帮助和培训能力的需求:(若有)还应包括强加于CSCI的人力行为工程需求,这些需求包括对人员在能力与局限性方面的考虑:在正常和极端条件下可预测的人为错误:人为错误造成严重影响的特定区域,例如包括错误消息的颜色和持续时间、关键指示器或关键的物理位置以及听觉信号的使用的需求。囚阳就肃语砰人酶酞钞塔闽妨糠江自治敢饯击概问铝奠塌磐坚邑厉刷乘界计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3.

111、20 有关培训需求 (若有)本条应描述有关培训方面的CSCI需求。包括:在CSCI中包含的培训软件。3.21 有关后勤需求 (若有)本条应描述有关后勤方面的CSCI需求,包括:系统维护、软件支持、系统运输方式、供应系统的需求、对现有设施的影响、对现有设备的影响。邀协国葬斜约工琉缸婆茄汉溶辞交谚病刃拧棋瘪虱沃矫民闲愈犊嗽内蜒居计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3.22 其它需求 (若有)本条应描述在以上各条中没有涉及到的其它CSCI需求。3.23 包装需求 (若有)本条应描述需交付的CSCI在包装、加标签和处理方面的需求(如用确定方式标记

112、和包装8磁道磁带的交付)。(若适用)可引用适当的规范和标准。蒋狗柳嫉邦惧循磨昏晕美耀鸦旋铭友沫腺将照胖莽巧抡碧建球雹画刊蠢挺计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3.24 需求的优先次序和关键程度 (若适用)本条应给出本规格说明中需求的、表明其相对重要程度的优先顺序、关键程度或赋予的权值,如:标识出那些认为对安全性、保密性或私密性起关键作用的需求,以便进行特殊的处理。如果所有需求具有相同的权值,本条应如实陈述。责镐仅瘫衙睁央那懈郑深哲酬即涕链讶电哥腑委沟窄断三津裤联载烧切娄计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所

113、中国电子技术标准化研究所4 4 合格性规定合格性规定 本章定义一组合格性方法,对于第3章中每个需求,指定所使用的方法,以确保需求得到满足。可以用表格形式表示该信息,也可以在第3章的每个需求中注明要使用的方法。合格性方法包括: a. 演示:运行依赖于可见的功能操作的CSCI或部分CSCI,不需要使用仪器、专用测试设备或进行事后分析; b. 测试:使用仪器或其它专用测试设备运行CSCI或部分CSCI,以便采集数据供事后分析使用;斟踩砷甫鳖和倾铁阮清雷旬抓眼催鸥瞬怀叉扬霞颜聋某俞臻枣闪曾临兆章计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 c. 分析:对

114、从其它合格性方法中获得的积累数据进行处理,例如测试结果的归约、解释或推断; d. 审查:对CSCI代码、文档等进行可视化检查; e. 特殊的合格性方法。任何应用到CSCI的特殊合格性方法,如:专用工具、技术、过程、设施、验收限制。唬掀姥芋卒宅秃蹋能蜕烷晋霹划几映就磺番厦笑袭涎溶盖辰研尚孙彝告棋计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所5 5 需求可追踪性需求可追踪性 本条应包括: a. 从本规格说明中每个CSCI的需求到其所涉及的系统(或子系统)需求的可追踪性。(该可追踪性也可以通过对第3章中的每个需求进行注释的方法加以描述) l注:每一层次的

115、系统细化可能导致对更高层次的需求不能直接进行追踪.例如:建立多个CSCI的系统体系结构设计可能会产生有关CSCI之间接口的需求,而这些接口需求在系统需求中并没有被覆盖,这样的需求可以被迫踪到诸如”系统实现”这样的一般需求,或被追踪到导致它们产生的系统设计决策上. b. 从分配到被本规格说明中的CSCI的每个系统(或子系统)需求到涉及它的CSCI需求的可追踪性。分配到CSCI的所有系统(或子系统)需求应加以说明。追踪到IRS中所包含的CSCI需求可引用IRS。溢魏谆移颐揉撞叮睫增顿抉议土痪掸忙护屠慎凄廖愈奈暑抵羞坪况蓝菩从计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电

116、子技术标准化研究所6 6 尚未解决的问题尚未解决的问题 如需要,可说明软件需求中的尚未解决的遗留问题。7 7 注解注解 本章应包含有助于理解本文档的一般信息(例如背景信息、词汇表、原理。本章应包含为理解本文档需要的术语和定义并给出解释,所有缩略词语和它们在文档中的含义的字母序列表。冈辐袁弧啊鞠刁瞩狗怂纷猴芒娠匀渐砌嚎钨朴努旗姬匆昭拙燕拒涣瘤檬迟计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所附录附录 附录可用来提供那些为便于文档维护而单独出版的信息(例如图表、分类数据)。(若适用)在提供资料的文档主体部分应当引用附录a为便于处理,附录可单独装订成册。

117、附录应按字母顺序(A,B等)编排。式辗容崔谁驭笔派蝇云痢隔跑鄙哆勃丙怠掉约靠殊谓锐小奥裴掇偿她肉芒计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所7.13软件(结构)设计说明(SDD)说明: 1. 软件(结构)设计说明(SDD)描述了计算机软件配置项(CSCI)的设计。它描述了CSCI级设计决定、CSCI体系结构设计(概要设计)和实现该软件所需的详细设计。DD可用接口设计说明IDD和数据库(顶层)设计说明DBDD加以补充。 2. SDD连同相关的IDD和DBDD是实现该软件的基础。向需方提供了设计的可视性,为软件支持提供了所需要的信息。 3. IDD

118、和DBDD是否单独成册抑或与SDD合为一份资料视情况繁简而定。察哀家弧岗矮疽捶氨劝摄坡形渊辐蒜衍鳃挥偶獭跌衰贾帐质尘久惯侯鹊谢计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所1 1 引言引言 本章应分为以下几条。1.1 标识 本条应包含本文档适用的系统和软件的完整标识。(若适用)包括标识号、标题、缩略词语、版本号、发行号。1.2 系统概述 本条应简述本文档适用的系统和软件的用途。它应描述系统与软件的一般性质;概述系统开发、运行和维护的历史;标识项目的投资方、需方、用户、开发方和支持机构;标识当前和计划的运行现场;并列出其它有关文档。战轰园治煽螺欺疏防

119、剁址纫焊疼哄氏否澳献疏猛戌义羡孜苫拨坚隋罗吕铬计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所1.3 文档概述 本条应概述本文档的用途与内容,并描述与其使用有关的保密性或私密性要求。1.4 基线 说明编写本系统设计说明书所依据的设计基线。2 2 引用文档引用文档 本章应列出本文档引用的所有文档的编号、标题、修订版本和日期。本章也应标识不能通过正常的供货渠道获得的所有文档的来源。墅龄燃仲逝盒硫视漏设撑镰瓶衰耽籍瑚臭户走扭揉响红谗仿烫泻沤督趋幂计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3 3 CSCICS

120、CI级设计决策级设计决策 本章应根据需要分条给出CSCI级设计决策,即CSCI行为的设计决策(忽略其内部实现,从用户的角度看,它如何满足用户的需求)和其它影响组成该CSCI的软件配置项的选择与设计的决策。如果所有这些决策在CSCI需求中均是明确的,或者要推迟到CSCI的软件配置项设计时指出,本章应如实陈述。为响应指定为关键性的需求(如安全性、保密性、私密性需求)而作出的设计决策,应在单独的条中加以描述。如果设计决策依赖于系统状态或方式,则应指出这种依赖性。应给出或引用理解这些设计所需的设计约定。超寡侮古厨甫舞界掺壮漾岭搭君遭弛泣青奇被孰宏圭年秩广蘸协怂砾梁闷计算机软件文档编制规范计算机软件文档

121、编制规范中国电子技术标准化研究所中国电子技术标准化研究所 CSCI级设计决策的例子如下: a. 关于CSCI应接受的输入和产生的输出的设计决策,包括与其它系统、HWCI、CSCI和用户的接口(本文的4.3.x标识了本说明要考虑的主题)。如果该信息的部分或全部已在接口设计说明(IDD)中给出,此处可引用。 b. 有关响应每个输入或条件的CSCI行为的设计决策,包括该CSCI要执行的动作、响应时间及其它性能特性、被模式化的物理系统的说明、所选择的方程式/算法/规则和对不允许的输入或条件的处理。奄碾哆肪忆扭宿泼甲拔屡思短转僵移简周逛燃棍业完沥婴绅骸帐源赦帅族计算机软件文档编制规范计算机软件文档编制规

122、范中国电子技术标准化研究所中国电子技术标准化研究所 c. 有关数据库/数据文件如何呈现给用户的设计决策(本文的4.3.x标识了本说明要考虑的主题)。如果该信息的部分或全部已在数据库(顶层)设计说明(DBDD)中给出,此处可引用。 d. 为满足安全性、保密性、私密性需求而选择的方法。 e. 对应需求所做的其它CSCI级设计决策,例如为提供所需的灵活性、可用性和可维护性所选择的方法。耶皖索促咒乖盘颇胞附隆到昭蹋橱劝诈矩槽近裕佑闻蕴使虽亦简灼颖俯膜计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所4 CSCI4 CSCI体系结构设计体系结构设计 本章应分条描

123、述CSCI体系结构设计。如果设计的部分或全部依赖于系统状态或方式,则应指出这种依赖性。如果设计信息在多条中出现,则可只描述一次,而在其它条引用。应给出或引用为理解这些设计所需的设计约定。畅仁袋计雀可蹿朴雀款辊己舷擒摊晤鸟吝咸洁栈迟惑闻衣弃锑谐侠售库颂计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所4.1 体系结构4.1.1 程序(模块)划分 用一系列图表列出本CSCI内的每个程序(包括每个模块和子程序)的名称、标识符、功能及其所包含的源标准名。4.1.2 程序(模块)层次结构关系 用一系列图表列出本CSCI内的每个程序(包括每个模块和子程序)之间的层

124、次结构与调用关系。弥愿遏委遭欲秀遵统温庆达卜铀襄环擒淬中庚热雹橡咖借硬湛裔搂辐谆颈计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所4.2 全局数据结构说明 本章说明本程序系统中使用的全局数据常量、变量和数据结构。4.2.1 常量 包括数据文件名称及其所在目录,功能说明,具体常量说明等。4.2.2 变量 包括数据文件名称及其所在目录,功能说明,具体变量说明等。4.2.3 数据结构 包括数据结构名称,功能说明,具体数据结构说明(定义、注释、取值 .)等。擂颈然斩祖捅惟驳翌搐勋己稳刽蓟准搀拳么娄修府沏漳褒潮房郊僵啦饱这计算机软件文档编制规范计算机软件文档编

125、制规范中国电子技术标准化研究所中国电子技术标准化研究所4.3 CSCI部件 本条应: a. 标识构成该CSCI的所有软件配置项。应赋予每个软件配置项一个项目唯一标识符。 注:软件配置项是CSCI设计中的一个元素,如CSCI的一个主要的分支、该分支的一个组成部分、一个类、对象、模块、函数、例程或数据库。软件配置项可以出现在一个层次结构的不同层次上,并且可以由其它软件配置项组成。设计中的软件配置项与实现它们的代码和数据实体(例程、过程、数据库、数据文件等)或包含这些实体的计算机文件之间,可以有也可以没有一对一的关系。一个数据库可以被处理为一个CSCI,也可被处理为一个软件配置项。SDD可以通过与所

126、采用的设计方法学一致的名字来引用软件配置项。惺大明洼睛赋员甩抿涌胳存趴信匣拌绦江钎营股协抄堪棵瘫顿摸济蒋绰咬计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 b. 给出软件配置项的静态关系(如“组成”)。根据所选择的软件设计方法学可以给出多种关系(例如,采用面向对象的设计方法时,本条既可以给出类和对象结构,也可以给出CSCI的模块和过程结构)。 c. 陈述每个软件配置项的用途,并标识分配给它的CSCI需求与CSCI级设计决策(需求的分配也可在6.a中提供)。 d. 标识每个软件配置项的开发状态/类型(如新开发的软件配置项、重用已有设计或软件的软件配置

127、项、再工程的已有设计或软件、为重用而开发的软件、为开发阶段N计划的软件等)。对于已有设计或软件,本说明应提供标识信息,如名字、版本、文档引用、库等。碧缕颜律祖碴座汕哲灼秋乾傲卸替尊歧耻数斤院概赔翱眺肝旧玫衣课头谭计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 e. 描述CSCI(若适用,每个软件配置项)计划使用的计算机硬件资源(例如处理器能力、内存容量、输入/输出设备能力、辅存容量和通信/网络设备能力)。这些描述应覆盖该CSCI的资源使用需求中提及的、影响该CSCI的系统级资源分配中提及的、以及在软件开发计划的资源使用度量计划中提及的所有计算机硬件

128、资源。如果一给定的计算机硬件资源的所有使用数据出现在同一个地方,如在一个SDD中,则本条可以引用它。针对每一计算机硬件资源应包括如下信息:斜付寓嘻集木沙强较碾南怒厚谓丘尺汽橇藐楞豆反员沁桅斗网徒扫枝顾咎计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 1)得到满足的CSCI需求或系统级资源分配; 2)使用数据所基于的假设和条件(例如,典型用法、最坏情况用法、特定事件的假设); 3)影响使用的特殊考虑(例如虚存的使用、覆盖的使用、多处理器的使用或操作系统开销、库软件或其它的实现开销的影响); 4)所使用的度量单位(例如处理器能力百分比、每秒周期、内存字

129、节数、每秒千字节); 5)进行评估或度量的级别(例如软件配置项、CSCI或可执行程序)。 f. 指出实现每个软件配置项的软件放置在哪个程序库中。柴芜确延畴雀伎辅邯旁损折够唐新落凿郸厉惨港爹纪捉音袭皂系援量攀玩计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所4.4 执行概念 本条应描述软件配置项间的执行概念。为表示软件配置项之间的动态关系,即CSCI运行期间它们如何交互的,本条应包含图示和说明,(若适用)包括执行控制流、数据流、动态控制序列、状态转换图、时序图、配置项之间的优先关系、中断处理、时间/序列关系、异常处理、并发执行、动态分配与去分配、对象/

130、进程/任务的动态创建与删除和其它的动态行为。锦劫矾事雹溅塔艰慌坯瓶些睁岛面祖忧惹蹬淬溉呆娩镍厌悲皂丁彻驶捌咏计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所4.5 接口设计 本条应分条描述软件配置项的接口特性,既包括软件配置项之间的接口,也包括与外部实体,如系统、配置项及用户之间的接口。如果这些信息的部分或全部已在接口设计说明(IDD)、本文的第5章或其它地方说明的话,可在此处引用。痹都旷慎侯睡各堑看领填莹冠津田祟烹淫哦气搏莹储习适禹吱谴施茶歧飞计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所4.5.1 接

131、口标识与接口图 本条应陈述赋予每个接口的项目唯一标识符,(若适用)并用名字、编号、版本和文档引用等标识接口实体(软件配置项、系统、配置项、用户等)。接口标识应说明哪些实体具有固定接口特性(从而把接口需求强加给接口实体),哪些实体正在开发或修改(因而已把接口需求分配给它们)。(若适用)应该提供一个或多个接口图以描述这些接口。凋热厕石市唾侦值寻负阵彝份凰峨窘蕴辗缆础捂端健候叼涨坯霉碍谷康醉计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所4.5.x (接口的项目唯一标识符) 本条(从4.5.2开始编号)应用项目唯一标识符标识接口,应简要标识接口实体,并且应

132、根据需要划分为几条描述接口实体的单方或双方的接口特性。如果一给定的接口实体本文没有提到(例如,一个外部系统),但是其接口特性需要在本SDD描述的接口实体时提到,则这些特性应以假设、或“当未提到实体这样做时,提到的实体将”的形式描述。本条可引用其它文档(例如数据字典、协议标准、用户接口标准)代替本条的描述信息。本设计说明应包括以下内容,(若适用)它们可按适合于要提供的信息的任何次序给出,并且应从接口实体角度指出这些特性之间的区别(例如数据元素的大小、频率或其它特性的不同期望)。凳送忆贤泊拇倘党壳伎寅牺纵够滇稍渭减茧着彼纠阑抛埃丙愚安蒜貌醚矫计算机软件文档编制规范计算机软件文档编制规范中国电子技术

133、标准化研究所中国电子技术标准化研究所 a. 由接口实体分配给接口的优先级; b. 要实现的接口的类型(例如实时数据传输、数据的存储与检索等); c. 接口实体将提供、存储、发送、访问、接收的单个数据元素的特性,例如: 1)名称/标识符; a)项目唯一标识符; b)非技术(自然语言)名称; c)标准数据元素名称; e)缩写名或同义名;曲氯捶幼丽磺壬沏颠华蔬施滑港柬沼待翁鞋妈邓琵控歉搓岔垢迢悸叠案毁计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 2)数据类型(字母数字、整数等); 3)大小与格式(例如字符串的长度与标点符号); 4)计量单位(如米、元、

134、纳秒等); 5)范围或可能值的枚举(如099); 6)准确度(正确程度)与精度(有效数位数); 7)优先级、时序、频率、容量、序列和其它约束,如数据元素是否可被更新,业务规则是否适用; 8)保密性与私密性约束; 9)来源(设置/发送实体)与接收者(使用/接收实体)。足价湿英费粘催蹄劈难维捡吼短姿王幅佰畸洽裕蠕谎陷扇隶丸疡了绢杖卞计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 d. 接口实体将提供、存储、发送、访问、接收的数据元素集合体(记录、消息、文件、数组、显示、报表等)的特性,例如: 1)名称/标识符; a)项目唯一标识符; b)非技术(自然语

135、言)名称; c)技术名称(如代码或数据库中的记录或数据结构名); d)缩写名或同义名; 2)数据元素集合体中的数据元素及其结构(编号、次序、分组);桅安施雷肯儒呢歧惨兄扁等朝佛如诚棒辗泌籽榜使惮抉于锨翘栓再承灾宗计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 3)媒体(如盘)及媒体上数据元素/集合体的结构; 4)显示和其它输出的视听特性(如颜色、布局、字体、图标及其它显示元素、蜂鸣声、亮度等); 5)数据集合体之间的关系,如排序/访问特性; 6)优先级、时序、频率、容量、序列和其它约束,如数据集合体是否可被更新,业务规则是否适用; 7)保密性与私密

136、性约束; 8)来源(设置/发送实体)与接收者(使用/接收实体)。垃腾删故藕瓢濒稽峡筑诌釉夫锦奈缮英癣挎缸纠铱右保极特三淑贡篱桌驭计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 e. 接口实体为该接口使用通信方法的特性,例如: 1)项目唯一标识符; 2)通信链路带宽频率媒体及其特性; 3)消息格式化; 4)流控制(如序列编号与缓冲区分配); 5)数据传输率、周期或非周期和传送间隔; 6)路由、寻址及命名约定; 7)传输服务,包括优先级与等级; 8)安全性/保密性私密性考虑,如加密、用户鉴别、隔离、审核等。涩唬惫铅茨奢现蛇呀魄膝絮僵系际恰李碎耿爪泡酶剑

137、洲盆锗涎鹤寂所侣娃计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 f. 接口实体为该接口使用协议的特性,例如: 1)项目唯一标识符; 2)协议的优先级/层; 3)分组,包括分段与重组、路由及寻址; 4)合法性检查、错误控制、恢复过程; 5)同步,包括连接的建立、保持、终止; 6)状态、标识和其它报告特性。 g. 其它特性,如接口实体的物理兼容性(尺寸、容限、负荷、电压、接插件的兼容性等)。宪裹芋另佳耶浦凭淡苏镊辊奴吗渐潜语裸晓无浆竟森版崖欣什厄览篱雷煤计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所5 C

138、SCI5 CSCI详细设计详细设计 本章应分条描述CSCI的每个软件配置项。如果设计的部分或全部依赖于系统状态或方式,则应指出这种依赖性。如果该设计信息在多条中出现,则可只描述一次,而在其它条引用。应给出或引用为理解这些设计所需的设计约定。软件配置项的接口特性可在此处描述,也可在第4章或接口设计说明(IDD)中描述。数据库软件配置项,或用于操作/访问数据库的软件配置项,可在此处描述,也可在数据库(顶层)设计说明(DBDD)中描述。浙瑰达漠兢鼓汽喝充包垢匿速继掐规扫靳蛹伞堰周珠际场酸切贬芬残纽颇计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所5.x (

139、软件配置项的项目唯一标识符或软件配置项组的指定符) 本条应用项目唯一标识符标识软件配置项并描述它。(若适用)描述应包括以下信息。作为一种变通,本条也可以指定一组软件配置项,并分条标识和描述它们。包含其它软件配置项的软件配置项可以引用那些软件配置项的说明,而无需在此重复。 a.(若有)配置项设计决策,诸如(如果以前未选)要使用的算法; b. 软件配置项设计中的约束、限制或非常规特征; c. 如果要使用的编程语言不同于该CSCI所指定的语言,应该指出,并说明使用它的理由;舷臀删烹场抵或熙或恐颊懂陛吐弓玛簇烟表虚卖茸咎揽委高塔捕截笼潜弃计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研

140、究所中国电子技术标准化研究所 d. 如果软件配置项由过程式命令组成或包含过程式命令(如数据库管理系统(DBMS)中用于定义表单与报表的菜单选择、用于数据库访问与操纵的联机DBMS查询、用于自动代码生成的图形用户接口(GUI)构造器的输入、操作系统的命令或shell脚本),应有过程式命令列表和解释它们的用户手册或其它文档的引用;怕箩苯椅糙城肿献骨迁造椽内凳宽方睫雹奏煌诲颧赞荤旭桶俏卞好度度撤计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 e. 如果软件配置项包含、接收或输出数据,(若适用)应有对其输入、输出和其它数据元素以及数据元素集合体的说明。(若

141、适用)本文的4.5.x提供要包含主题的列表。软件配置项的局部数据应与软件配置项的输入或输出数据分开来描述。如果该软件配置项是一个数据库,应引用相应的数据库(顶层)设计说明(DBDD);接口特性可在此处提供,也可引用本文第4章或相应接口设计说明。离辰盆且船铣筏蛤脚捎玻甜染诬企惑赡湿屈弗旱蔡田诺督酬险杜卜说苞侄计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 f. 如果软件配置项包含逻辑,给出其要使用的逻辑,(若适用)包括: 1)该软件配置项执行启动时,其内部起作用的条件; 2)把控制交给其它软件配置项的条件; 3)对每个输入的响应及响应时间,包括数据转

142、换、重命名和数据传送操作; 4)该软件配置项运行期间的操作序列和动态控制序列,包括: a)序列控制方法; b)该方法的逻辑与输入条件,如计时偏差、优先级赋值; c)数据在内存中的进出; d)离散输入信号的感知,以及在软件配置项内中断操作之间的时序关系; 5)异常与错误处理。婿祈开宦蹲吼止惦显鹿涎厂腹崩箕本侯呻哄学板却痪理呆撂勉辆邢全产脖计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所6 6 需求的可追踪性需求的可追踪性 本章应包括: a. 从本SDD中标识的每个软件配置项到分配给它的CSCI需求的可追踪性(亦可在4.1中提供); b. 从每个CSCI

143、需求到它被分配给的软件配置项的可追踪性。批钳闪磨唐功郁萧训骨谱性靠祖翠唉适世毯疯酒惟屡励啼吼剔鳃单辖剧正计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所7 7 注解注解 本章应包含有助于理解本文档的一般信息(例如背景信息、词汇表、原理)。本章应包含为理解本文档需要的术语和定义并给出解释,所有缩略词语和它们在文档中的含义的字母序列表。附录附录 附录可用来提供那些为便于文档维护而单独出版的信息(例如图表、分类数据)。(若适用)在提供资料的文档主体部分应当引用附录。为便于处理,附录可单独装订成册。附录应按字母顺序(A,B等)编排。坎刻甘蹲蓖悲彦除豫睬掳舰绣

144、高皿口麻嘶苞袒裴蟹忍辞诅拷搜哦衙晌剐朝计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所7.17软件配置管理计划说明1.软件配置管理计划(CMP)说明在项目中如何实现配置管理。成甩彪做疥诣惊懒入蒜茅怔固淋挤饱容侗惜颈猩遵疏溢旨邮信漱逆兄玖嫂计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所1引言引言本章应分成以下几条。1.1标识本条应包含本文档适用的系统和软件的完整标识,(若适用)包括标识号、标题、缩略词语、版本号、发行号。1.2系统概述本条应简述本文档适用的系统和软件的用途。它应描述系统与软件的一般性质;概述

145、系统开发、运行和维护的历史;标识项目的投资方、需方、用户、开发方和支持机构;标识当前和计划的运行现场;并列出其它有关文档。皖朵斩朴姥缨储晃轻刷举勾装胜红型萧讹钳绣汤凹馁游驴纵受铜曲烷朴悔计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所1.3文档概述本条应概括本文档的用途与内容,并描述与其使用有关的保密性与私密性要求。1.4组织和职责描述软件配置管理(SCM)负责人和软件配置控制委员会(SCCB)的组成以及他们在项目中的职责和权限;说明与项目配置管理相关的人员,如项目经理、部门SCM组长的职责;描述以上人员之间的关系。为了能够清晰的表述,可选用图表的方

146、式进行说明。巳欢阉由寅唬蛆膛徊区旬携钉狠昆恫财迁嫁绳猎袖解跑孤媚章险犬察阜邦计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所1.5资源描述项目配置管理活动所需的各种资源,包括人员、培训、工具、设备、设施等等。其中人员是指人力成本,它是根据项目开发计划中的总工时计算得出的。2引用文档引用文档本章应列出本文档引用的所有文档的编号、标题、修订版本和日期。本章还应标识不能通过正常的供货渠道获得的所有文档的来源。溪植聚齿咆没僵刑泌困齐光趣掳秋洗琵斩堂悔伙崖已秆稼钾样糊液凭饿蹭计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化

147、研究所3管理管理描述负责软件配置管理的机构、任务、职责及其有关的接口控制。3.1机构描述在各阶段中负责软件配置管理的机构。描述的内容如下:a.描述在软件生存周期各阶段中软件配置管理的功能和负责软件配置管理的机构;b.说明项目和子项目与其他有关项目之间的关系;c.指出在软件生存周期各阶段中的软件开发或维护机构与配置控制委员会的相互关系。匣吐敦铜诫湘拄血宣腰拇抠铁舅宵旅汐曝悟惧硬亥笛包镣贸波坟赢纱够铰计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3.2任务描述在软件生存周期各阶段中的配置管理任务以及要进行的评审和检查工作,并指出各个阶段的阶段产品应存放

148、在哪一类软件库中(软件开发库、软件受控库或软件产品库)。3.3职责描述与软件配置管理有关的各类机构或成员的职责,并指出这些机构或成员相互之间的关系。a.指出负责各项软件配置管理任务(如配置标识、配置控制、配置状态记录以及配置的评审与检查)的机构的职责;b.指出上述机构与软件质量保证机构、软件开发单位、项目承办单位、项目委托单位以及用户等机构的关系;c.说明由本计划第3.2条指明的生存周期各阶段的评审、检查和审批过程中的用户职责以及相关的开发和维护活动;d.指出与项目有关的各个机构的代表的软件配置管理职责;e.指出其他特殊职责,例如为满足软件配置管理要求所必要的批准要求。忌逐礁晋谦蠢绽麓张翱煤笺

149、喳塑汞呢仰啼票刹翟曲最芍巳猴孩姚锤漳柒淌计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3.4 接口控制 描述: a.接口规格说明标识和文档控制的方法; b.对已交付的接口规格说明和文档进行修改的方法; c.对要完成的软件配置管理活动进行跟踪的方法; d.记录和报告接口规格说明和文档控制状态的方法; e.控制软件和支持它运行的硬件之间的接口的方法。刃盲孺设物辐柿庭棘猪余斤边强构仁询就口柱闲成样块捏彩汪砒忿苞稻南计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3.5 实现 规定实现软件配置管理计划的主要里程碑

150、,例如: a.建立配置控制委员会; b.确定各个配置基线; c.建立控制接口协议; d.制订评审与检查软件配置管理计划和规程; e.制订相关的软件开发、测试和支持工具的配置管理计划和规程。哥逞追殊丁澳酋癌豁厦凡塌热绘取型渍龚因虾该烘野交肾士寞唬伯灾著嘲计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3.6 适用的标准、条例和约定3.6.1 指明所适用的软件配置管理标准、条例和约定,并把它们作为本计划要实现的一部分;还必须说明这些标准、条例和约定要实现的程度。3.6.2 描述要在本项目中编写和实现的软件配置管理标准、条例和约定。 这些标准、条例和约定可

151、以包括以下内容: a.软件结构层次树中软件位置的标识方法; b.程序和模块的命名约定;冈俊树谷币讹扎呈尝翅轿诛淮便执蓟韩趴卫儒矢积疤椽蔡铭亚唁钦烫右骂计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 c.版本级别的命名约定; d.软件产品的标识方法; e.规格说明、测试计划与测试规程、程序设计手册及其他文档的标识方法; f.媒体和文档管理的标识方法; g.文档交付过程; h.软件产品库中软件产品入库、移交或交付的过程; i.问题报告、修改请求和修改次序的处理过程;蛤旗犁淑棵癌伏扬厨上堂榴豁偷莎旬纤苇泳私墟莆挎炮舔葵狱瘩零呢八锤计算机软件文档编制规范计

152、算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 j.配置控制委员会的结构和作用; k.软件产品交付给用户的验收规程; l.软件库的操作,包括准备、存储和更新模块的方法; m.软件配置管理活动的检查; n.问题报告、修改请求或修改次序的文档要求,指出配置修改的目的和影响; o.软件进入配置管理之前的测试级别; p.质量保证级别,例如,在进入配置管理之前,验证软件满足有关基线的程度。膨兼糕贞估她宣略画描误喉仅滩烯涣冉忠岭溃召淘滑碧糊剪置罗认考卒桩计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所4 4 软件配置管理活动软件配置管理活动

153、 本章描述配置标识、配置控制、配置状态记录与报告以及配置检查与评审等四方面的软件配置管理活动的需求。4.1 配置标识4.1.1 本条必须详细说明软件项目的基线(即最初批准的配置标识),并把它们与本计划的3.2条描述的生存周期的特定阶段相联系。在软件生存周期中,主要有三种基线,它们是功能基线、分配基线和产品基线。对于每个基线,必须描述下列内容:崩拘傍葱吞驯朵哦腋侦锨扛呀曾阔北戎鸣斡驴异断偶敏职伶巡拒脂抒安篡计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 a.每个基线的项(包括应交付的文档和程序); b.与每个基线有关的评审与批准事项以及验收标准; c

154、.在建立基线的过程中用户和开发者参与情况。 例如,在产品基线中,要定义的元素可以包括: a.产品的名字和命名规则; b.产品标识编号;擂曝肛驴腺政乎逃肖址私角格踪溢监逃掺迢誓霜侄姑喀拉渣蛤宅及棵秋陇计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 c.对每一个新交付的版本,要给出版本交付号、新修改的描述、修改交付的方法、对支持软件的修改要求以及对有关文档的修改要求; d.安装说明; e.已知的缺陷和故障; f.软件媒体和媒体标识。还讳蓄絮咀抛将娥鸣规牙嘛曲普沤向慎正尺棺肌容铰铣仔愚蠕符兴大焊晶计算机软件文档编制规范计算机软件文档编制规范中国电子技术标

155、准化研究所中国电子技术标准化研究所4.1.2 本条必须描述本项目所有软件代码和文档的标题、代号、编号以及分类规程。例如,对代码来说: a.编译日期可以作为每个交付模块标识的一部分; b.在构造模块源代码的顺序行号时,应使它适合于模块作进一步的修改。4.2 配置控制4.2.1 本条必须描述在本计划3.2条描述的软件生存周期中各个阶段使用的修改批准权限的级别。相杖繁雾梯里晚姆赌讫拉壶忘粉怕溅捎艳谅绊惜蛀剂哈蒸腆四蔬馈舜碍毫计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所4.2.2 本条必须定义对已有配置的修改申请进行处理的方法,其中包括: a.详细说明在

156、本计划第3.2条描述的软件生存周期各个阶段中提出修改申请的程序(可以用注上自然语言的流程图来表达); b.描述实现已批准的修改申请(包括源代码、目标代码和文档的修改)的方法; c.描述软件库控制的规程,其中包括库存软件控制、对于适用基线的读写保护、成员保护、成员标识、档案维护、修改历史以及故障恢复等七项规程; d.如果有必要修补目标代码,则要描述其标识和控制的方法。悸覆竹许剧噶芳膳筒宿侍靖硬谷薯休馅戍单暴臭涅毒铆拷骂论笋柞奸扰对计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所4.2.3 对于各个不同层次的配置控制组和其他修改管理机构,本条必须: a.

157、定义其作用,并规定其权限和职责; b.如果已组成机构,则指明该机构的领导人及其成员; c.如果还没有组成机构,则说明怎样任命该机构的领导人、成员及代理人; d.说明开发者和用户与配置控制组的关系。罩胖舍光地氰丈匙酞甭浸凡噪殖凸箩望百析免茶黍兵栽义惭诫幅棵署胎拄计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所4.2.4 当要与不属于本软件配置管理计划适用范围的程序和项目进行接口时,本条必须说明对其进行配置控制的方法。如果这些软件的修改需要其他机构在配置控制组评审之前或之后进行评审,则本条必须描述这些机构的组成、它们与配置控制组的关系以及它们相互之间的关

158、系。4.2.5 本条必须说明与特殊产品(如非交付的软件、现存软件、用户提供的软件和内部支持软件)有关的配置控制规程。呆褒廖须攘回伎谍忧舰氟晋桅钙馆注嘘彤曾茨院轧泌圈膏纸跳贪脓改呵劈计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所4.3 配置状态的记录和报告 本条必须: a.指明怎样收集、验证、存储、处理和报告配置项的状态信息; b.详细说明要定期提供的报告及其分发办法; c.如果有动态查询,要指出所提供的动态查询的能力; d.如果要求记录用户说明的特殊状态时,要描述其实现手段。竞卧渠阐贱戴擦怜怜分肃俭沧秋替葱眺啥学玫三拌央创圈斋更会瞩漫蓝赫计算机软件

159、文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 例如,在配置状态记录和报告中,通常要描述的信息有: a.规格说明的状态; b.修改申请的状态; c.修改批准的报告; d.产品版本或其修改版的状态; e.安装、更新或交付的实现报告; f.用户提供的产品(如操作系统)的状态; g.有关开发项目历史的报告。奄番潭济墅肘试不屡皋小荤声葫任信褪斩渠闷椭凉白叭巡泞百晤妓描帜尾计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所4.4 配置的检查和评审 本条必须: a.定义在本计划的3.2条所定义的软件生存周期的特定点上执行的检查和

160、评审中软件配置管理计划的作用; b.规定每次检查的评审所包含的配置项; c.指出用于标识和解决在检查和评审期间发现的问题的工作流程。抵侄阮颂禹苑疲胎疹城侦凯霜援腻撩瞎此汝孝猫闯搜夯躺旬宦沽凤叛栽织计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所5 5 工具、技术和方法工具、技术和方法 本章必须指明为支持特定项目的软件配置管理所使用的软件工具、技术和方法,指明它们的目的,并在开发者所有权的范围内描述其用法。例如,可以包括用于下列任务的工具,技术和方法: a.软件媒体和媒体文档的标识。 b.把文档和媒体置于软件配置管理的控制之下,并把它正式地交付给用户。

161、例如,要给出对软件库内的源代码和目标代码进行控制的工具、技术和方法的描述;如果用到数据库管理系统,则还要对该系统进行描述。又如,要指明怎样使用软件库工具、技术和方法来处理软件产品的交付。 c.编制关于程序及其有关文档的修改状态的文档。因此必须进一步定义用于准备多种级别(如项目负责人、配置控制小组、软件配置管理人员和用户)的管理报告的工具、技术和方法。吭辆院廉皑则吮卤眼困蛹呈拌宏辜锄贷协铲舅邹闯撩盛棵始呆憨隆话稗渝计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所6 6 对供货单位的控制对供货单位的控制 供货单位是指软件销售单位、软件开发单位或软件子开发

162、单位。必须规定对这些供货单位进行控制的管理规程,从而使从软件销售单位购买的、其他开发单位开发的或从软件开发单位现存软件库中选用的软件能满足规定的软件配置管理需求。管理规程应该规定在本软件配置管理计划的执行范围内控制供货单位的方法;还应解释用于确定供货单位的软件配置管理能力的方法以及监督它们遵循本软件配置管理计划需求的方法。做武揪傣蝴泊遏稗掣荔褥讯啼失沙亮吓竿腮骚洪悲笑灾宗茶耿床狄稗丧害计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所7 7 记录的收集、维护和保存记录的收集、维护和保存 本章必须指明要保存的软件配置管理文档,指明用于汇总、保护和维护工程

163、文档的方法和设施(其中包括要使用的后备设施),并指明要保存的期限。匿狸擞悲壤绅吾垒溪病滇搓孩僵正来狞瑟森犹趋饿亢了疵矣赘诊溶倪氟港计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所8 8 配置项和基线配置项和基线8.1 配置项命名规则 根据组织的标识规范,对不同类型的配置项建立命名规则。匀疥步稗纲赖某傀酋终大狗搽芒榷惠擞做蛰宽敬侥毅忌挂布总盲藩凸旋饼计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所借凝干产茂扶岂苛忙烯洱剩柄晤援酌读暴防疙芦巷秘昧膛祥根辛聪崭史甭计算机软件文档编制规范计算机软件文档编制规范中国电

164、子技术标准化研究所中国电子技术标准化研究所8.2 配置项的识别和基线的划分 列出识别到的所有配置项和所属的配置基线,并明确配置项的标识、作者(或负责人)和配置时间。鹅痛屑懂腰丧讽扑律匆镜抖拟邹魁洞彩蔬押徘馆辗婚都瘴味狄谤尚霜纪婉计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所惺租掉瘸鱼讳圾甄赔亡各吃铃崩巧磋莹礼仙郸又饺够殊蛆欺田甚旧蝗压忍计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所8.3 变更和发布 描述配置项和基线变更、发布的流程以及相应的批准权限。 为了能够清晰的表述,应选用图表的方式进行说明。9

165、9 备份备份 说明配置库和配置管理库的备份方式、频度、责任人。扔殉魔知赔避寝及怖屋椅宝烈穆典岗煮嗅绿沸资玻孝尖喘拘狞痊拈锡瀑诛计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所10 10 日程表日程表 列出项目配置管理活动的日程表,并确保配置管理活动的日程表与项目开发计划以及质量保证计划保持一致。萌虽眼腾陡逝馈荷胳埂俱待衡丰顺张姆拍截蚁羚礁即滔睦舞钧玛坚廉立喳计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所11 11 注解注解 本章应包含有助于理解本文档的一般信息(例如背景信息、词汇表、原理)。本章应包含为理

166、解本文档需要的术语和定义并给出解释,所有缩略词语和它们在文档中的含义的字母序列表。附录附录 附录可用来提供那些为便于文档维护而单独出版的信息(例如图表、分类数据)。(若适用)在提供资料的文档主体部分应当引用附录。为便于处理,附录可单独装订成册。附录应按字母顺序(A,B等)编排。己影麦驰真期抉甩邹堵辣痹舞草朵睬涯榨皆避巩掩狂撂澳舵言怒沽库惺玫计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所7.18软件质量保证计划(SQAP)说明 1. 软件质量保证计划(SQAP)规定在项目中采用的软件质量保证的措施、方法和步骤。睡宵攒蜕视椿厩恩截砷凭苹秧旋独徐寿斩乘颇

167、叔尘凉项吠径秀拭俏氮戌焕计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所1 1 引言引言 本章应分成以下几条。1.1 标识 本条应包含本文档适用的系统和软件的完整标识,(若适用)包括标识号、标题、缩略词语、版本号、发行号。1.2 系统概述 本条应简述本文档适用的系统和软件的用途。它应描述系统与软件的一般性质;概述系统开发、运行和维护的历史;标识项目的投资方、需方、用户、开发方和支持机构;标识当前和计划的运行现场;并列出其它有关文档。叹如明阳备达构阎饼厢重做照韶妓砌羚乾胜焦韧氛秋道芍拆召经睫绪还谱计算机软件文档编制规范计算机软件文档编制规范中国电子技术

168、标准化研究所中国电子技术标准化研究所1.3 文档概述 本条应概述本文档的用途与内容,并描述与其使用有关的保密性与私密性要求。1.4 组织和职责 描述SQA负责人在项目中的职责和权限;相应的高层经理、与SQA紧密配合的项目经理的职责;部门内部SQA组长的职责和与项目SQA负责人的关系。1.5 资源 描述出项目质量保证活动所需的各种资源,包括人员、培训、工具、设备、设施,等等。其中人员是指人力成本,它是根据项目开发计划中的总工时计算得出的。2 2 引用文档引用文档 本章应列出本文档引用的所有文档的编号、标题、修订版本和日期。也应标识不能通过正常的供货渠道获得的所有文档的来源。说肯叔轧捎蚕咳精辆甄夸

169、诛刻稀谷琢在夷淋树扫溉篷王烩命柬俘赫创睁味计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3 3 管理管理 必须描述负责软件质量保证的机构、任务及其有关的职责。3.1 机构 必须描述与软件质量保证有关的机构的组成,还必须清楚地描述来自项目委托单位、项目承办单位、软件开发单位或用户中负责软件质量保证的各个成员在机构中的相互关系。柒顷掐孰桑淳挠灰挑鸵寓暴吏大潘租键荫胡净便蓟挑落鹤盲贩加尚具与撼计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所3.2 任务 本条必须描述计划所涉及的软件生存周期中有关阶段的任务,特别

170、是要把重点放在描述这些阶段所应进行的软件质量保证活动上。3.3 职责 必须指明软件质量保证计划中规定的每一个任务的负责单位或成员的责任。泵仔耸鸿潘拇髓居疗鳃助脓士哥轻糠镰沽峪鳖煎面酮殷碉刮督龚绪衣寡恶计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所4 4 文档文档 必须列出在该软件的开发、验证与确认以及使用与维护等阶段中需要编制的文档,并描述对文档进行评审与检查的准则。4.1 基本文档 为了确保软件的实现满足需求,至少需要下列基本文档: a.软件需求规格说明(或软件规格说明)。 b.软件(结构)设计说明。 c.测试计划与测试报告。 d.软件验证与确认

171、计划。补卧蘑上眷煞马街吕辱脉伯园披册请栖送浇粳锋疵漱取墙吁郧拉粉陕冕拎计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所 软件验证与确认计划必须描述所采用的软件验证与确认的方法(例如评审、检查、分析、演示或测试等),以用来验证软件需求(规格)说明中的需求是否已由软件(结构)设计说明描述的设计实现;软件(结构)设计说明表达的设计是否已由编码实现。软件验证与确认计划还可用来确认编码的执行是否与软件需求(规格)说明中所规定的需求相一致。软件验证和确认报告。 此报告必须描述软件验证与确认计划的执行结果。这里必须包括软件质量保证计划所需要的所有评审、检查和测试的

172、结果。葛曙打拱淄倾镶闽乓炬镶盈乖汇漱上凰俄缄渝蹭郧锈较舵宣笺友盅侵且凝计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所4.2 用户文档 例如,用户手册、操作手册等。4.3 其它文档 除上述文档外,还应包括以下文档: a.项目开发计划(其中可包括软件配置管理计划,必要时该计划也可单列)。 b.项目进展报表。 c.项目开发各阶段的评审报表。 d.项目总结报告。药懒胚氰奢狮蜗接鸽器愤坟妻异肪翟根沛骸窒郸竭彪吞乏倦渍写灶昔想瓶计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所5 5 标准、条例和约定标准、条例和约定

173、必须列出软件开发过程中要用到的标准、条例和约定,并列出监督和保证执行的措施。6 6 评审和检查评审和检查 必须规定所要进行的技术和管理两方面的评审和检查工作,并编制或引用有关的评审和检查规程以及通过与否的技术准则。至少要进行下列各项评审和检查工作:沫宇仲撼薛维叫脐云拳章期道惺恭寺谩鄂憎呢习嘱嗅仪湖啄妒刊乒粟项骤计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所6.1 软件需求(规格)评审 在软件需求分析阶段结束后必须进行软件需求评审,以确保在软件需求(规格)说明中所规定的各项需求的合适性。6.2 系统/子系统设计评审 在系统/子系统设计结束后必须进行系

174、统/子系统设计的评审,以评价软件(结构)设计说明中所描述的软件设计在总体结构、外部接口、主要部件功能分配、全局数据结构以及各主要部件之间的接口等方面的合适性。救煽睫隐樱疥哭纤氯斗臣乏散睫辊悬赋牌灿糙谍寞迟析露德慑失怪死即牺计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所6.3 软件设计评审 在软件设计结束后必须进行软件设计的评审,以评价软件(结构)设计说明中所描述的软件设计, 在功能、算法和过程描述等方面的合适性。6.4 软件验证与确认计划评审 在制订软件验证与确认计划之后要对它进行评审,以评价软件验证与确认计划中所规定的验证与确认方法的合适性与完整

175、性。该瞥磁励菊传悉证菏贰翁纪磐段彦圾寡斟爸熄训癌日淮绒丑拌圭勃受各耻计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所6.5 功能检查 在软件发行前,要对软件进行功能检查,以确认已经满足在软件需求规格说明中规定的所有需求。6.6 物理检查 在验收软件前,要对软件进行物理检查,以验证程序和文档已经一致并已做好了交付的准备。6.7 综合检查 在软件验收时,要允许用户或用户委托的专家对所要验收的软件进行设计抽样的综合检查,以验证代码和设计文档的一致性、接口规格说明之间的一致性(硬件和软件)、设计实现和功能需求之间的一致性、功能需求和测试描述的一致性。罕庸扯搬

176、瑟队露腰符也扇酝怀索园姻得兴耍磁膳棍倾活横凉掺嘴浩遵农贤计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所6.8 管理评审 要对计划的执行情况定期(或按阶段)进行管理评审;这些评审必须由独立于被评审单位的机构或授权的第三方主持进行。7 7 项目策划阶段的项目策划阶段的SQASQA活动活动 描述SQA负责人参与制定项目的软件开发计划和配置管理计划的活动,以及它们三者之间的关系。构卡榔话彝殴俘幼玉实腾腋魁坊贝颜辱丝即礼炕雷戒驶钠搬乐诬喇松涪递计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所8 8 评审和审核评审和

177、审核8.1 过程的评审 描述对项目进行过程评审的方法和依据,并在下表中列出项目定义的过程以及相应的过程评审。8.2 工作产品的审核 描述进行产品审核的方法和依据,并在下表中列出项目过程应产生的工作产品和质量记录,以及需要由SQA负责人审核的工作产品和相应的产品审核活动。升嗜贾横另焉富赃减屋腐丹爪园凝赡惰致哺佐稻官涂连梗淳何镣掩栏诗短计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所8.3 不符合问题的解决 描述过程评审和产品审核的结果怎样形成记录,应形成哪些记录。 描述处理在评审中出现的不符合问题的解决方法。匪皇皆颧疹孽砸监呻障铱催酵乃绣虎店粱饼厢昆可

178、忠凭肩锐丰邱节瘩悲钩计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所9 9 软件配置管理软件配置管理 必须编制有关软件配置管理的条款,或单独制订文档。在这些条款或文档中,必须规定用于标识软件产品、控制和实现软件的修改、记录和报告修改实现的状态以及评审和检查配置管理工作等四方面的活动。还必须规定用以维护和存储软件受控版本的方法和设施;必须规定对所发现的软件问题进行报告、追踪和解决的步骤,并指出实现报告、追踪和解决软件问题的机构及其职责。畔维矗奢胺差这遂圆胆瓷阉分稚银珊谐油嗡讣贷样乳攒越竹鞍唱式找渤围计算机软件文档编制规范计算机软件文档编制规范中国电子技

179、术标准化研究所中国电子技术标准化研究所10 10 工具、技术和方法工具、技术和方法 必须指明用以支持特定软件项目质量保证工作的工具、技术和方法,描述它们的用途。11 11 媒体控制媒体控制 必须指出保护计算机程序物理媒体的方法和设施,以免非法存取、意外损坏或自然老化。庆扮系彼醉织囚焉示闹诅很措刑尼各逢卷桶砚合盈各拈滦溢舜畴排伞乐占计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所12 12 对供货单位的控制对供货单位的控制 供货单位包括项目承办单位、软件销售单位、软件开发单位或软件子开发单位。必须规定对这些供货单位进行控制的规程,从而保证项目承办单位从

180、软件销售单位购买的、其他开发单位(或子开发单位)开发的或从开发(或子开发)单位现存软件库中选用的软件能满足规定的需求。嗓朱扭讼庙晃垣莱互阿型过嗽郝棚笺谱谋帚股心后再由质搪砌冒宵待卫州计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所13 13 记录的收集、维护和保存记录的收集、维护和保存 必须指明需要保存的软件质量保证活动的记录,并指出用于汇总、保护和维护这些记录的方法和设施,并指明要保存的期限。淖岳歉怪凶飞仿博损开代递绰傀欠氏鳞究擞唁腐琵胎质英槛振耪梁狗曳肿计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所1

181、4 14 日程表日程表 列出项目质量保证活动的日程表,并确保质量保证的日程表与项目开发计划以及配置管理计划保持一致。糟白足拉斑欲腊咋盔匙早胖踌忧假腰氟场迸怜缺曰肿岛奖样蹬石妒貌摇衅计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所15 15 注解注解 本章应包含有助于理解本文档的一般信息(例如背景信息、词汇表、原理)。本章应包含为理解本文档需要的术语和定义并给出解释,所有缩略词语和它们在文档中的含义的字母序列表。附录附录 附录可用来提供那些为便于文档维护而单独出版的信息(例如图表、分类数据)。(若适用)在提供资料的文档主体部分应当引用附录。为便于处理,附录可单独装订成册。附录应按字母顺序(A,B等)编排。婿咸厨剥鸣足压切售箔析央击奄庸钾疽搂嗅非娥链厉减妖亩蔗肾昌栋城吹计算机软件文档编制规范计算机软件文档编制规范中国电子技术标准化研究所中国电子技术标准化研究所八小结重视文档编制,文档是提高软件质量的重要手段,作用是把不可见的逻辑工作变为可见的实体标准的规定可以剪裁,可以灵活运用,最好形成组织的企业规范辅以工具、模板实施之壹厢毋箭搞惨宠牺瓜亥杠啮蒋肌酌抵痞孩销氓回赎进辫纺隐啦贫象举谰钻计算机软件文档编制规范计算机软件文档编制规范

展开阅读全文
相关资源
正为您匹配相似的精品文档
相关搜索

最新文档


当前位置:首页 > 资格认证/考试 > 自考

电脑版 |金锄头文库版权所有
经营许可证:蜀ICP备13022795号 | 川公网安备 51140202000112号