需求设计写作培训需求设计写作培训质量管理部质量管理部SQA小组小组2005.06课程范围u仅关注如何写作文档u不涉及具体的需求分析和设计方法课程内容l为什么要文档化l文档写作基本要求l需求设计文档模板l需求文档写作l设计文档写作为什么要文档化开发人员通过文档化的过程查错补遗；便于评审，在早期发现技术上的问题；后续阶段开发任务可能由他人承担，输出文档便于他们开展工作；维护人员开展维护工作需要；文档是必要的交付件；可读性就尤为关键为什么要文档化“所有的过程分析都要形成文档我们现在有一个严重的问题是，大家好像不喜欢写文档，对于需要的实现方案，通常都是一个负责人在脑袋里想想该怎么实现，然后邮件或找几个相关人员讨论一下就算可以了，可能连个会议材料或会议纪要都没有而老外可不是这样的，他们非常非常重视文档，他们认为一个人在脑袋里想的东西是不清晰也不全面的，有时候心里想的认为很正确的方案实际上可能存在致命缺陷他们要求必须把心里的想法形成文档才能有效的避免这种问题写文档的过程中，可以更加有效的、更进一步去整理您原来心里的思路，很多问题在您写过文档的过程中您就能发现；另外，文档写作多使用图表，浪费口水的文字尽量少用，和我们一起工作的系统工程师在系统架构分析中就画了五六十张图，就算看不懂他写的英文，从图中我们就能够很清晰的指导整个产品的系统架构。
摘自一位华为员工的瑞典出差报告5课程内容l为什么要文档化l文档写作基本要求l需求设计文档模板l需求文档写作l设计文档写作文档写作基本要求下面的文档出自于我们开发人员的手笔，大家觉得如何？文档写作基本要求应使用标准模板写作；文档封页、页眉页脚、修订记录、附录、参考文献应完善；关键词、摘要、缩略语应完整；目录要及时更新；通篇文档标题、文字格式、间距应协调美观；所有文档模板中的章节，只可增加，不可删除；编写建议是用来指导文档写作的，在利用完后要及时删除；图号置于图形之下，表号置于表格之上；文档写作基本要求应追求图文并茂的效果；句子和段落要短；使用语言应严谨，不要使用白话；采用主动语气；不要出现“我们”、“你们”、“他们”这样的称谓，或“这个”、“那个”这样的词，应使用“本”、“该”、“其”；表述清晰，避免引起歧义；通篇文档细节上要保持一致；练习 房子南北走向，房子大门在东侧中间位置门厅长约3米，宽2米，门厅左面是主卧室，右面是厨房厨房3米宽，4米长，厨房门对着门厅，厨房的顶头还有一个北阳台，与厨房同宽，长1米主卧室宽3米，长5米左右，房间门对着客厅客厅与餐厅连为一体，共7米长，4米宽，与客厅相连有一南阳台，与客厅同宽，长1.5米。
餐厅的北面是卫生间，卫生间与厨房相对，中间由1米宽，3米长的过道隔开；卫生间门对着过道，南墙与厨房的南墙在一条直线上；卫生间为长方形，南墙长3米，另一边长2米卫生间的北面是次卧，同宽，门朝着过道，次卧长4米过道的北端是书房门，书房南北长4米，书房有一个一米见方的门厅，书房的西墙长4米，包括1米长的门厅长度，西墙把书房和次卧分隔开门厅东墙北端90角折向东，长2米，把书房和厨房北阳台分隔开大家认为下面的描述如何？究竟长多少？?是左？是左？还是右？还是右？大段的叙述，大段的叙述，不利于理解！不利于理解！10练习1.房子南北走向，房子大门在东侧中间位置2.门厅长3米，宽2米，门厅左面是主卧室，右面是厨房3.厨房3米宽，4米长，厨房门对着门厅，厨房的顶头还有一个北阳台，与厨房同宽，长1米4.主卧室宽3米，长5米左右，房间门对着客厅5.客厅与餐厅连为一体，共7米长，4米宽，与客厅相连有一南阳台，与客厅同宽，长1.5米6.餐厅的北面是卫生间，卫生间与厨房相对，中间由1米宽，3米长的过道隔开；卫生间门对着过道，南墙与厨房的南墙在一条直线上；卫生间为长方形，南墙长3米，另一边长2米7.卫生间的北面是次卧，同宽，门朝着过道，次卧长4米。
8.过道的北端是书房门，书房南北长4米，书房有一个一米见方的门厅，书房的西墙长4米，包括1米长的门厅长度，西墙把书房和次卧分隔开门厅东墙北端90角折向东，长2米，把书房和厨房北阳台分隔开修改成如下描述之后呢？练习主卧室主卧室次卧室次卧室厨房厨房餐厅餐厅客厅客厅阳台阳台阳台阳台卫生间卫生间书房书房门厅门厅过道过道北北西西再改成如下图形描述呢？练习LSW与CAMS配合实现认证计费的方案中，客户（禁止多人同时使用的业务帐号）登陆通过认证开始计费后，如果出现LSW重起的情况，处理方法分为两种：1.有时间芯片的LSW（可以记录时间的），设备重起后会使用设备时间戳的特性判断出设备重起了，这时会将CAMS上的用户删除并按照最后一次计费更新报文来终结计费用户可再次正常登陆2.下面的描述呢？白话修改成如下的描述呢？1.使用时间芯片的LSW（支持记录时间功能），利用设备时间戳特性可以检测出设备是否重启，设备重启时将CAMS上的用户删除，并依据最后一次计费更新报文终结计费用户可再次正常登陆练习由于一台设备可以设置多个radius服务器，也就是radius scheme用户可以通过命令行来配置该radius服务器是否启动设备重启防吊死功能。
由于一台设备可以设置多个radius服务器，即radius scheme用户可以通过命令行来配置该radius服务器是否启动设备重启防吊死功能练习CAMS收到该报文后会立即回应一个code=5的计费回应报文，然后根据accounting-on报文携带的NAS-IP和NAS-ID找到通过该设备认证的用户，并将他们的信息删除CAMS收到该报文后会立即回应一个code=5的计费回应报文，然后根据accounting-on报文携带的NAS-IP和NAS-ID找到通过该设备认证的用户，并将其信息删除15练习修改原因：这个函数是将要发送的packet转化为buffer，系统原有函数RD_PutPacketToBuffer是针对认证用户设计的，由于本特性为设备启动后执行，没有用户信息，所以在RD_PutPacketToBuffer函数基础上做了一些修改，形成该函数修改原因：该函数实现将待发送的packet转化为buffer的功能，系统原有函数RD_PutPacketToBuffer针对认证用户设计，由于本特性为设备启动后执行，没有用户信息，所以在RD_PutPacketToBuffer函数基础上做了一些修改，形成该函数。
练习ARP Authorized加强了网络安全，阻止了DHCP server对非法ARP回应进行学习，并且通过周期的ARP ping可以快速的探测到用户是否下线在设备的接口上使能ARP Authorized，该接口的ARP动态学习功能被禁止在某个接口上禁止arp动态学习，不影响其他接口的arp学习在禁止了arp动态学习的接口上，只能通过手工添加静态arp，或者其他一些被允许的模块才可以添加arp，这种arp被称为ARP Authorized，授权arp不再和其他的动态表项一样老化，而是有自己的老化机制，后面会说明DHCP server就是这样的一个模块静态arp的优先级高于授权arp，也就是说可以覆盖授权arp1.ARP与arp、ARP Authorized与授权arp，使用术语应该统一；2.ARP Authorized应先解释后引用；3.“DHCP server就是这样的一个模块”，是否相关？课程内容l为什么要文档化l文档写作基本要求l需求设计文档模板l需求文档写作l设计文档写作模板何处获取需求SRS文档：REP01T01接口文档：REP01T03设计概要设计：DVP05T01详细设计：DVP05T03软件设计：DVP05T04移植设计：DVP05T05需求设计合一来自华为北研所h3crnd01-fs软件部规范小特性开发规范模板需求设计需求设计文档模板19课程内容l为什么要文档化l文档写作基本要求l需求设计文档模板l需求文档写作l设计文档写作什么是好的需求什么样的需求是好的需求完整性清晰性可行性一致性可验证性练习2.1.1Functional Requirements1 功能需求1修改设置smarton password命令1.Introduction介绍 在设置smarton password的同时，规定密码显示形式为明文和密文。
2.Inputs 输入 1)密码显示形式2)smarton password3.Process 处理 1)记录密码显示形式2)当密码显示形式为simple时，直接设置smarton password为设置值；当密码显示形式为cipher时，如果设置值是密文，先将其进行解密成明文再设置，如果是明文则直接设置4.output输出 无5.Inherit继承性 Update-需要改进大家看看下面的需求描述如何？1.介绍中描述的显示形式有明文和密文两种，但处理中描述的显示形式却是simple和cipher，不一致；2.密码允许输入哪些字符，长度有无限制，均没有交待不完整3.输出没有吗？不完整练习2.1.1配置或者取消配置系统WOL功能1.Introduction介绍 在系统视图下配置或者取消配置WOL使能2.Inputs 输入 系统视图下:wol enable 或 undo wol enable3.Process 处理 在系统视图下配置或者取消WOL使能去系统WOL使能时，将WOL模块的MAC-ADDR表清空，释放所占内存初始化MAC地址表相关指针4.output输出 WOL功能在系统中被使能或被去使能；去系统使能时，MAC-ADDR表被清空。
5.Inherit继承性 NEW-新增功能在前面没有介绍的情况下，这里应对缩略语进行详细解释，否则不完整练习2.1.1SRS.FUNC.DHG.001 IKE模块支持DH交换时使用Group5，Group141.Introduction介绍 支持IKE DH组的Group5和Group14是由8040波兰提出的新需求，用户希望能提供更高安全级别的安全密钥，希望能支持DH 3/4/5，但是DH Group3/4是由椭圆曲线来实现的，与Group1/2/5有很大的区别，且需要较大的工作量，因此本次特性开发暂且实现对Group5/14的支持完整性：这种术语也应该简单介绍，毕竟不是算数学题练习2.2.18 R.FUNC.018支持XRN堆叠 3.Process 处理 当unit down时，处理端口删除消息，把down掉的unit端口从镜像组中删除，由此可能有相应的镜像组状态的改变当收到unit up消息时，本unit向其它unit发送端口镜像同步消息此消息包含本unit所配置的镜像组信息2.2.1Performance Requirements 性能需求1.Performance Requirements1 性能需求1 通话语音要求流畅。
可能”、“流畅”都是不清晰的，不同人理解不一样不清晰一般也不可验证25SRS大纲l简介目的范围l总体概述软件概述软件功能用户特征假设和依赖关系l需求建模建模工具l具体需求功能需求性能需求外部接口需求l总体设计约束标准符合性硬件约束技术限制l软件质量属性可维护性可靠性l依赖关系l其他需求l需求分级l附录简介总体总体概述概述具体具体需求需求设计设计约束约束质量质量属性属性简介简介附录附录依赖依赖关系关系其它其它需求需求目的目的范围范围l描述文档目的l指明文档读者l软件命名l软件要做什么，不做什么l软件的应用要点：“目的”是针对文档，“范围”针对的是软件功能练习1Introduction 简介1.1Purpose 目的 本文用于描述DHCP增强项目中ARP相关需求的需求及设计，满足以下分配需求：1.在接口上禁止ARP动态学习；2.允许DHCP server添加授权ARP；3.ARP PING；4.配置授权ARP老化时间；5.如果dhcp server删除租约则应删除相应的arp；6.删除授权ARP表项后删除租约；本文适用于相关开发及维护人。