构建之法阅读笔记06
在此次阅读之前我并不知道原来软件还有规格说明,也不知道文档对一个软件从业者竟是如此重要。
规格说明指的是系统为满足用户需求而提供的解决方案,规定了解系统的行为特征。一般来说,软件产品需求规格说明书(SRS)的可能目的是:定义软件总体要求,作为用户和软件开发人员之间相互了解的基础;提供性能要求、初步设计和对用户影响的信息,作为软件人员进行软件结构设计和编码的基础;作为软件总体测试的依据。
规格说明书(Specification)简称Spec,分为以下两种:
1、软件功能说明书(Functional Spec),主要用来说明软件的外部功能和用户的交互情况(把软件当作一个黑盒子)。
2、软件技术说明书(Technical Spec),又称为设计文档(Design Doc),主要用来说明软件内部的实际规范(把软件当作一个透明的箱子)。
功能说明书是指从客户的角度出发描述产品的功能、输入、输出、界面、功能的边界问题、功能的效率(对用户而言)、国际化、本地化、异常情况等,不涉及软件内部的实现细节。而写好Spec就是把一件事情描述清楚。要定义好相关的概念、好处、目标等;规范好一些假设;避免一些误解,界定一些边界条件,要避免二义性的情况,让大家讨论,形成共识,同时还要征求客户的意见;描述主流的用户/软件交互步骤;一些好的功能可能会有副作用,我们要把这些副作用明明白白的写出来;服务质量说明,软件团队要说明服务质量是什么等级,意味着什么,不然就会人云亦云,以谬传缪。
而我们要做的就是实践,实践,再实践。
在今后的学习与实践中我一定会以设计思路为阵地多加练习文档书写。