??xml version="1.0" encoding="utf-8" standalone="yes"?>
如今QY件开发越来越复杂QY件功能也来丰富。而几乎所有成熟的商业软gQ都是靠一个开发团队齐心协力的血汗结晶?#8220;|马不是一天徏成的Q?#8221;Q当我们震撼于Microsoft Windows的惊世巨著的同时Q也道听途说了微软公司Y件工E是如何的完善规范。的,集数癑员工几年的共同努力之大成QY仉目管理的成|是控制开发成本的关键环节。这里面Q少不了贯穿其中的重要步?---软g文档。Y件文档可以分为开发文档和产品文档两大cR开发文档包括:《功能要求》、《投标方案》、《需求分析》、《技术分析》、《系l分析》、《数据库文档》、《功能函数文档》、《界面文档》、《编译手册》、《QA文档》、《项目ȝ》等。品文档包括:《品简介》、《品演C》、《疑问解{》、《功能介l》、《技术白皮书》、《评报告》、《安装手册》、《用手册》、《维护手册》、《用h告》、《销售培训》等?br> 一、开发文?br>1. 《功能要求?-来源于客戯求和市场调查Q是软g开发中最早期的一个环节。客hZ个模p的功能概念Q或者要求解决一个实际问?nbsp;Q或者照同类软g的一个功能。有软gl验的客戯会提供比较详l的技术规范书Q把他们的要求全部列表书写在文档中,必要时加以图表解说。这份文档是需求分析的基础?br>2. 《投标方案?-Ҏ(gu)用户的功能要求,l过与招标方沟通和认Q技术h员开始书写《投标方案》,Ҏ(gu)书一般包括以下几个重要的章节Q前a--目背景、公司背景和业务、技术h员结构、公司的成功案例介绍{。需求分?-目要求、Y件结构、功能列表、功能描q、注意事等。技术方?-M要求和指导思想、技术解x案、Y件开发^台、网l结构体pȝ。项目管?-描述公司的Y件开发流E、工E实施服务、组l和人员分工、开发进度控制、Y件质量保证、项目验收和人员培训、Y件资料文档等。技术支?-公司的技术支持和服务介绍、服务宗旨和目标、服务别和响应旉、技术服务区域、技术服务期限、授权用戯pMh{。系l报?-软、硬件^台报价列表、Y件开发费用、系l维护费用等。项目进?-整个目的进度计划,包括{v合同、项目启动、需求分析、系l分析、程序开发、测试维护、系l集成、用户验收、用户培训等步骤的时间规划?br>3. 《需求分析?-包括产品概述、主要概c操作流E、功能列表和解说、注意事V系l环境等。以《功能要求》ؓ基础Q进行详l的功能分析(包括客户提出的要求和Ҏ(gu)开发经验徏议的功能)Q列出本产品是什么,有什么特D的概念Q包括那些功能分c,需要具备什么功能,该功能的操作如何Q实现的时候该注意什么细节,客户有什么要求,pȝq行环境的要求等。这里的功能描述跟以后的使用手册是一致的?br>4. 《技术分析?-包括技术选型、技术比较、开发h员、关键技术问题的解决、技术风险、技术升U方向、技术方案评P竞争Ҏ(gu)技术分析等。以《需求分析》ؓ基础Q进行详l的技术分?产品的性能和实现方?Q列出本目需要用什么技术方案,Z么,有哪些技术问题要解决Q估计开发期间会到什么困难,技术方案以后如何升U,Ҏ(gu)目的技术有什么评L?br> 5. 《系l分析?-包括功能实现、模块组成、功能流E图、函数接口、数据字典、Y件开发需要考虑的各U问题等。以《需求分析》ؓ基础Q进行详l的pȝ分析(产品的开发和实现Ҏ(gu))Q估计开发期间需要把什么问题说明白Q程序员Ҏ(gu)《系l分析》,开始在目ȝ的带领下q行~码?br>6. 《数据库文档?-包括数据库名U、表名、字D名、字D늱型、字D说明、备注、字D|D公式等。以《系l分析》ؓ基础Q进行详l的数据库设计。必要时可以用图表解_特别是关pL据库?br>7. 《功能函数文档?-包括变量名、变量初植、功能,函数名,参数Q如何调用、备注、注意事等。以《系l分析》ؓ基础Q进行详l的说明Q列出哪个功能涉及多个函数Q以便以后程序员修改、接手和扩展?br>8. 《界面文档?-包括软g外观、界面素材、编辑工兗文件名、菜单、按钮和其它界面部g的要求,q里与Y件完成后的运行界面是一致的?br>9. 《编译手册?-包括服务器编译环境、操作系l、编译工兗GNU的C++~译器版本信息、目录说明、程序生成、源E序文g列表、Makefile配置及其相关E序的对应关pd表。客L的编译过E、编译结果、编译示例、编译环境、操作系l、编译工兗源文g列表和制作安装程序的q程?br>10. 《QA文档?-包括产品介、品原理、品功能列表、功能描q、功能流E、执行结果、数据库l构、测试要求等Q提供给软g试人员使用?br>11. 《项目ȝ?-包括目介、项目参与h员和开发时?/span>
]]>
CMMI标准名词术语
1 AT Assessment Team 评审组
2 ATM Assessment Team Member 评审组成员
3 BA Baseline Assessment 基线评审
4 CAR Causal Analysis and Resolution 原因分析与决{?br>5 CBA CMM-Based Appraisal ZCMM的评?br>6 CBA-IPI
CMM-Based Appraisal for Internal Process
Improvement
为内部过E改q而进行的ZCMM的评P通常
UCؓCMM评审Q?br>7 CC Configuration Controller 配置理?br>8 CF Common Feature 公共Ҏ(gu)?br>9 CFPS Certified Function Point Specialist 注册功能点专?br>10 CI Configuration Item 配置?br>11 CM Configuration Management 配置理
12 CMM Capability Maturity Model 能力成熟度模?br>13 CMMI Capability Maturity Model Integration 能力成熟度集成模?br>14 COTS Commerce off the shelf 商业现货供应
15 DAR Decision Analysis and Resolution 决策分析与制?br>16 DBD Database Design 数据库设?br>17 DD Detailed Design 详细设计
18 DP Data Provider 数据提供?br>19 DR Derived Requirement z需?br>20 EPG Engineering Process Group 工程q程组
21 FP Function Point 功能?br>22 FPA Function Point Analysis 功能点分?br>23 FR Functional Requirement 功能性需?br>24 GA Gap Analysis 差距分析
25 ID Interface Design 接口设计
26 IFPUG International Function Point Users Group 国际功能点用Ll?br>27 IPM Integrated Project Management 集成目理
28 IR Interface Requirement 接口需?br>29 KPA Key Process Area 关键q程?br>30 KR Key Requirements 关键需?br>31 LA Lead Assessor MQ评审?br>32 MA Measurement and Analysis 量与分?br>33 MAT Metrics Advisory Team 度量咨询l?br>34 MCA Metrics Coordinator and Analyst 度量专员
35 ML matreraty library 度量数据?br>36 NFR Non-functional Requirement 非功能性需?br>37 OC Operational Concept 操作概念
38 OID Organizational Innovation and Deployment l织革新与部|?br>39 OPD Organizational Process definition l织q程定义
40 OPF Organizational Process focus l织q程焦点
41 OPL Organizational Process Assets l织q程财富
42 OPP Organaizational Process Perormance l织q程性能
43 OSSP Organization’s Set of Standard Process
l织标准q程集合
44 OT Organizational Training l织U培?br>45 PA Process Areas q程?br>46 PAT Process Action Team q程行动组
47 PB Process Assets Library q程财富?br>48 PD Preliminary Design 概要设计
49 PDSP Project Defined Standard Processes 目定义标准q程
50 PI Produce Integration 产品集成
51 PLC Product Life Cycle 产品生命周期
52 PMC Project Monitoring and Control 目监控
53 PP Project Planning 目{划
54 PPQA Process and Product Quality Assurance q程与品质量保?br>55 PPR Price Performance Ratio 性能h?br>56 QA Software Quality Assurance 软g质量保证
57 QA Quality Assurance 质量保证
58 QAP Software Quality Assurance Plan 质量保证计划
59 QPM Quantitative Project Management 量化目理
60 RD Requirements Development 需求开?br>61 RM/ReqM Requirements Management 需求管?br>62 RSKM Risk Management 风险理
63 RTM Requirement Traceability Matrix 需求跟t矩?br>64 SAM Supplier Agreement Management. 供应协议理
65 SC Steering Committee 指导委员?br>66 SCAMPI
Standard CMMI Assessment Method for
Process Improvement q程改进CMMI标准评审Ҏ(gu)
67 SCCB Software Configuration Control Board 软g配置理控制委员?br>68 SCM Software Configuration Management 软g配置理
69 SDP Software Development Plan 软g开发计?br>70 SEI Software Engineering Institute (国)软g工程学院
71 SEPG Software Engineering Process Group 软g工程q程l?br>72 SPI Software Process Improvement 软gq程改进
73 SPP Software Project Planning 软g目{划
74 SPTO Software Project Tracking and Oversight 软g目跟踪与监?br>75 SR System Requirements pȝ需?br>76 SRS Software Requirement Specification 软g需求规?br>77 SSM Software Subcontract Management 软g分包理
78 SSR Software System Requirement 软gpȝ需?br>79 TS Technical Solution 技术解x?br>80 UC Use Case 用例
81 UID User Interface Design 用户界面设计
82 VAL Validation 认
83 VER Verification 验证
84 WBS Work Breakdown Structure 工作分解l构
85 WP Work Products 工作产品
86 Pre-assessment 预评?br>87 Baseline 基线
88 Quality Attribute 质量属?br>89 Scenario 场景
规范1: 对于听觉及视觉的内容要提供相{的替代文字内容
规范2: 不要单独靠色彩来提供Ҏ(gu)信息
规范3: 适当C用标记语a和样式窗?nbsp;
规范4: 阐明自然语言的?nbsp;
规范5: 建立~排良好的表?nbsp;
规范6: 保|页能在新科技下良好地呈现
规范7: 保使用者能处理旉敏感内容的改?br>规范8: 保嵌入式用者接口具有直接可及?br>规范9: 设计装置独立|页
规范10: 使用q渡的解x?br>规范11: 使用国际与国内官方订定的技术和规范
规范12: 提供内容导引信息
规范13: 提供清楚的浏览网站机?br>规范14: 保单清楚的|页内容
规范一: 对于听觉及视觉的内容要提供相{的替代文字内容
码
1.1囄需要加上替代文字说?nbsp;
1.2对于applet提供替代文字说明
1.3对于object提供替代文字说明
1.4对于H体中的囑Ş按键提供替代文字说明
1.5影像地图区域需要加上替代文字说?br>1.6当媄像地图用ؓ上传按钮Ӟ每一作用区域必须分别使用不同的按?nbsp;
1.7当alt属性的文字陈述大于150个英文字W时Q考虑另外提供文字叙述
1.8提供longdesc以外的描q性超U链?如D链接)Q来描述l(f)ongdesc的内?nbsp;
1.9囑Ş替代文字陈述不够清晰Ӟ提供更多的文字描q?如用longdesc属?
1.10所有语x案必L文字旁白
1.11以可及性的影像来替代ASCII文字艺术
1.12视讯中的声音必须提供同步文字型态的旁白
1.13服务器端影像地图中的链接必须在网中有额外对应的文字链接
1.14多媒体视觉媄像呈现时Q必L供听觉说?br>1.15多媒体呈现时Q必d步生相对应替代的语x文字说明
1.16客户端媄像地图中的超U链接必d|页中有额外对应的可及性超U链?br>
规范?不要单独靠色彩来提供Ҏ(gu)信息
码
2.1保所有藉由颜色所传达出来的讯息,在没有颜色后仍然能够传达出来
2.2保前景颜色与背景颜色彼此呈现明昄Ҏ(gu)
规范?适当C用标记语a和样式窗?br>码
3.1以实际存在的标记语言(如MathML)呈现|页内容(如数学方E式)Q避免用图形媄像呈?br>3.2定|页设计檔,有效使用正规的HTML语法
3.3在doctype标签中,使用标准规范的叙qC识别HTML版本cd
3.4可能用样式窗体控制网|版与内容的呈?br>3.5要用相对尺??)而非l对寸(如像?
3.6适当使用巢状标题呈现文gl构
3.7避免使用header标签来生粗体字效果
3.8目W号及编号之h(如li、ul)仅可使用于实际网内容的目条列Q不可用于编辑格?br>3.9保q和blockquote标签只是用来当引用语而不是用来羃?br>3.10以q及blockquoteh来标记引用语
规范?阐明自然语言的?br>码
4.1明确地指出网内容中语言的{?br>4.2用abbr及avronym标签表示|页中呈现的文字~写与简U?br>4.3明确指出|页文字所使用的自然语a
规范?建立~排良好的表?br>码
5.1对于每一个存放数据的表格Q不是用来排版)Q标C出行和列的标题
5.2表格中超q二?列以上的标题Q须以结构化的标记确认彼此间的结构与关系
5.3在网内容呈现设计时Q避免以表格做多
栏文字的设计
5.4若表格只做ؓ版面配置Ӟ勿用表gl构标记(如thh)作ؓ|页格式视觉效果
5.5表格L供表格摘要说?如summary属?
5.6数据表格L供标题说?nbsp;
5.7表格行列q长的标题,L供羃写或U?br>
规范?保|页能在新科技下良好地呈现
码
6.1使用 CSS 样式表编排的文g需保在除L式表后仍然能够阅?br>6.2|q结必须是HTML档案
6.3使用Script语言需指定不支持Script时的办法
6.4若网内的程序对象没有作用时Q确保网内容仍然可以传?br>6.5若网对象用事仉动时Q确定勿仅用鼠标操?br>6.6使用|时要指定不支持页框时的办?br>
规范?保使用者能处理旉敏感内容的改?br>码
7.1保|页设计不会致屏幕快速闪?br>7.2避免使用blinkh闪烁屏幕
7.3避免使用marqueehUd文字
7.4避免使用动态gif囄
7.5不要让网|隔一D|间自动更?br>7.6不要自动转移|页的网址
规范?保嵌入式用者接口具有直接可及?/font>
码
8.1对由Scripts、Applets及Objects所产生之信息,提供可及性替代方?/font>
规范?设计装置独立|页
码
9.1量使用客户端媄像地图替代服务器端媄像地图连l?br>9.2Ҏ(gu)有网内容元素,保有鼠标以外的操作接口
9.3保事g的启发不要求一定得使用鼠标
9.4具体指出按下Tab键在H体控gQ超U链接及对象间移动的序
9.5对经怋用的链接Q增加快速键的操?br>9.6对于H体lg考虑提供键盘快速键的操?br>
规范?使用q渡的解x?/font>
码
10.1除非使用者知道将会开启一个新H口Q不要随便开启一个新H口
10.2如果使用Script语言开启新H口或改变目前窗口的|址Q要让用者能事先知道
10.3保H体的控件与控g说明之间的配合很适当
10.4若有以表格直栏格式呈现的|页文字内容Ӟ提供U性文字替?br>10.5在网|字输入区中须有默认?br>10.6勿单以空白间隔分开相连之超U链?br>
规范十一:使用国际与国内官方订定的技术和规范
码
11.1如果你不能ɘq个|页无障化Q提供另一个相{的无障网?br>11.2量使用开放性的最新国际标准规?br>11.3避免使用q时的HTML语法
11.4允许使用者依照个人喜好设定网呈现方式与内容
规范十二:提供内容导引信息
码
12.1需要定义每个页框的名称
12.2如果|名称无法描述|中的内容的话Q应加上额外叙述
12.3把太长的选单目组h
12.4在窗体控件中Q用fieldset及legend标签作群l间的区?br>12.5可能将|页内容有相关之元素聚集在一?br>12.6在窗体控件上Q以labelh提示信息
规范十三:提供清楚的浏览网站机?br>码
13.1设计q确保有意义的超U链接说明,便于|页内容的阅?nbsp;
13.2如果需要的话,为每个超U链接加上内Ҏ(gu)q?nbsp;
13.3指向不同|址的超U链接,不可使用相同的超U链接说?nbsp;
13.4使用metadatah来记载计机可以了解q用的网信?br>13.5Z的网加上标?br>13.6Z的网站提供网站地图或整体性的?br>13.7|页设计使用清楚且一致的D机制
13.8提供|页Dq结工具列,以利存取|站Dl构
13.9能L别出意义上有组相关的超U链?br>13.10若有组链接Q在组之前增设一绕q此区域的超U链?br>13.11若网站具有搜d能,可以设计不同的网内Ҏ(gu)L式,以提供不同技能与喜好者搜寻选用
13.12在网|题、段落、及列表之前Q提供L别讯息以利识?br>13.13以metadata标签来识别网|件包含于整体文g内的所在位|?nbsp;
13.14QH313213 避免在网上使用ACSII文字艺术
规范十四:保单清楚的|页内容
码
14.1|页内容要用简单易懂的文字
14.2使用可及性的囑Ş促进|页内容的理?br>14.3|页彼此间设计呈现的风格要一?/font>