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