需求文档写作要点

 需求文档写作要点     

我的一篇老文章，偶然从机器里找出来，与大家共勉。

需求的写作形式一般分为两种，面向对象和面向过程。对于不同的受众和应用,采取不同的形式。
面向过程的形式：
主要的思想是IPO的原则，也就是“输出－处理－输出”
文档格式，
一、首先是对于整体系统的简略介绍：目的，确定文档描述的对象和大体内容
二、系统上下文，介绍系统和其他系统之间的关系，边界如何划分
三、系统的需求分解，介绍完成整体系统需要分解的大框架的需求内容
四、具体需求
对于具体需求很简单，按照如下形式完成：
1、简介
2、输入
3、处理
4、输出
五、除了具体需求外，还包括其他相关方面的需求：
1、接口需求（与其他系统、子系统、模块的接口，用户接口等）所谓的界面原型，其实是接口需求中的内容。由于界面原型通常都很重要，所以可以将这一部分拿出来放到具体需求中去。
界面原型不是仅仅一张图，还包括界面元素的描述、范围、错误提示信息等
2、性能需求
3、依赖：依赖的数据库、第三方软件等
4、需求优先级排序，用于衡量开发策略
六、参考文档

面向对象的形式，整体文档架构是和上面描述的一致，区别只有两点。
一、在系统的需求分解处，用用例的包图来描述、这个很简单，其实就是上面文字描述的图形化显示
二、主要区别是具体需求，通过用例的形式来描述，包括
1、介绍
2、用户（actor）
3、前置条件
4、后置条件
5、触发条件
6、事件流
7、备选事件流
具体的写法，可以参考《编写有效用例》，这是写用例我见过的最好参考书