软件功能说明书书写注意事项(一)
本注意事项更倾向于Web版的产品,以下是从事Web版功能设计工作时的一些经验(零零散散的)。仍以当前的“软件功能说明书”为模板
-
功能描述之应用场景中,重要的是场景,而不是界面操作。
-
在特性说明书写时,要为用户考虑,怎么来方便用户使用。让用户随时取到他想要的数据,于是就有必要将数据关联起来。写某一模块时,要考虑和它关联的数据对应的模块。
-
在内部使用时不需要验证码;
-
需要知道页面上有哪些元素(界面导航做的是元素的布局),参考以下的“思考”
-
特性说明中的描述(支持与不支持)
1) 支持(带有指向性的描述)
1) 不支持(带有指向性的描述)
1) 仅支持(排他性的描述)
1) 暂不支持(比如当前版本不支持,下个版本需要/可能支持)方便给参考软件功能说明书的设计人员与客户提供更多信息
1) 强制要求该怎么表示
-
可以给模板的应用场景开辟出“思考”一栏,可以将自己对某个方面的考虑写进去,方便设计人员明确,但不可过多,防止喧宾夺主
-
开辟专用名词定义/解释章节,给软件功能说明书/项目定下一些专用名词
-
可以将那些常用的字段写在附录中,通过不同的颜色、下划线等标记哪些字段是可以排序的,哪些是列表显示的(个人感觉这个不实用)
思考:
如果界面导航设计人员不懂业务,就不能将软件功能说明书中的描述转化为真正的界面设计,比如:
支持添加资源时引用盘点单中的资源;
本句中导航设计人员需要知道盘点单中到底有什么样子的资源。 以上的见解是针对于软件功能说明书编写者不参与设计、不填写软件功能说明书中的图例的设计的这种情况; 但是,问题在于:书写软件功能说明书要求编写者能够在书写完之后将某个模块或者整个项目的操作流程呈现在脑海中,同时,在每一个步骤中要考虑可能出现的问题以及如何更方便用户使用功能。于是编写者需要在界面上进行初步设计/规划,给导航设计人员一个参考。
blog comments powered by Disqus