求助:关于用户手册的编写

ghostcool2 2003-05-29 02:47:19
各位大虾是否能提供一些关于编写用户手册规范的资料,谢谢!!
...全文
446 10 打赏 收藏 转发到动态 举报
写回复
用AI写文章
10 条回复
切换为时间正序
请发表友善的回复…
发表回复
cina2002 2003-06-04
  • 打赏
  • 举报
回复
你看看,对你有帮助吗?

用户手册的编写:

1、引言
1.1 编写目的
说明编写这份用户手册的目的,指出预期的读者。
1.2 背景
说明:
a. 这份用户手册所描述的软件系统的名称。
b. 该软件项目的任务提出者、开发者、用户(或首批用)及安装此软件的计算中心。
1.3 定义
列出本文件中用到的专门术语的定义和外文首字母组词的原词组。
1.4 参考资料
列出有用的参考资料,如:
a. 项目的经核准的计划任务书或合同、上级机关的批文。
b. 属于本项目的其他已发表文件。
c. 本文件中各处引用的文件、资料,包括所要用到的软件开发标准。列出这些文件资料的标题、文件编号、发表日期和出版单位,说明能够取得这些文件资料的来源。

2、用途
2.1 功能
结合本软件的开发目的逐项地说明本软件所具有各项功能以及它们的极限范围。
2.2 性能
2.2.1 精度
逐项说明对各项输入数据的精度要求和本软件输出数据达到的精度,包括传输中的精度要求。
2.2.2 时间特性
定量地说明本软件的时间特性,如响应时间,更新处理时间,数据传输、转换时间,计算时间等。
2.2.3 灵活性
说明本软件所具有的灵活性,即当用户需求(如对操作方式、运行环境、结果精度、时间特性等的要求)有某些变化时,本软件的适应能力。
2.3 安全保密
说明本软件在安全、保密方面的设计考虑和实际达到的能力。

3、运行环境
3.1 硬设备
列出为运行本软件所要求的硬设备的最小配置,如:
a. 处理机的型号、内存容量。
b. 所要求的外存储器、媒体、记录格式、设备的型号和台数、联机/脱机。
c. I/O设备(联机/脱机)。
d. 数据传输设备和转换设备的型号、台数。
3.2 支持软件
说明为运行本软件所需要的支持软件,如:
a. 操作系统的名称、版本号。
b. 程序语言的编译/汇编系统的名称和版本号。
c. 数据库管理系统的名称和版本号。
d. 其他支持软件。
3.3 数据结构
列出为支持本软件的运行所需要的数据库或数据文卷。

4、使用过程
在本节,首先用图表的形式说明软件的功能同系统的输入源机构、输出接收机构之间的关系。
4.1 安装与初始化
一步一步地说明为使用本软件而需进行的安装与初始化过程,包括程序的存储形式、安装与初始化过程中的全部操作命令、系统对这些命令的反诮与答复。表征安装工作完成的测试实例等。如果有的话,还应说明安装过程中所需用到的专用软件。
4.2 输入
规定输入数据和参量的准备要求。
4.2.1 输入数据的现实背景
说明输入数据的现实背景,主要是:
a. 情况——例如人员变动、库存缺货。
b. 情况出现的频度——例如是周期性的、随机的、一项操作状态的函数。
c. 情况来源——例如人事部门、仓库管理部门。
d. 输入媒体——例如键盘、穿孔卡片、磁带。
e. 限制——出于安全、保密考虑而对访问这些输入数据所加的限制。
f. 质量管理——例如对输入数据合理性的检验以及当输入数据有错误时应采取的措施,如建立出错情况的记录等。
g. 支配——例如如何确定输入数据是保留还是废弃,是否要分配给其他的接受者等。
4.2.2 输入格式
说明对初始输入数据和参量的格式要求,包括语法规则和有关约定,如:
a. 长度——例如字符数/行,字符数/项。
b. 格式基准——例如以左面的边沿为基准。
c. 标号——例如标记或标识符。
d. 顺序——例如各个数据项的次序及位置。
e. 标点——例如用来表示行、数据组等的开始或结束而使用的空格、斜线、星号、字符组等。
f. 词汇表——给出允许使用的字符组合的列表,禁止使用带星号的字符组合的列表等。
g. 省略和重复——给出用来表示输入元素可省略或重复的表示方式。
h. 控制——给出用来表示输入开始或结束的控制信息。
4.2.3 输入举例
a. 控制或首部——例如用来表示输入的种类和类型的信息,标识符输入日期正文起点和对所用编码的规定。
b. 主体——输入数据的主体,包括数据文卷的输入表述部份。
c. 尾部——用来表示输入结束的控制信息,累计字符总数等。
d. 省略——指出哪些输入数据是可省略的。
e. 重复——指出哪些输入数据是重复的。
4.3 输出对每项作出的说明
4.3.1 输出数据的现实背景
说明输出数据的现实背景,主要是:
a. 使用——这些输出数据是给谁的,用来干什么。
b. 使用频度——例如每周的、定期的或备查阅的。
c. 媒体——打印、CRI显示、磁带、卡片、磁盘。
d. 质量管理——例如关于合理性检验、出错纠正的规定。
e. 支配——例如如何确定输出数据是保留还是废弃,是否要分配给其他接受者等。
4.3.2 输出格式
给出对每一类输出信息的解释,主要是:
a. 首部——如输出数据的标识符,输出日期和输出编号。
b. 主体——输出信息的主体,包括分栏标题。
c. 尾部——包括累计总数,结束标记。
4.3.3 输出举例
为每种输出类型提供例子。对例子中的每一项,说明:
a. 定义——每项输出信息的意义和用途。
b. 来源——是从特定的输入中抽出、从数据库文卷中取出、或从软件的计算过程中得到。
c. 特性——输出值域、计量单位、在什么情况下可缺省等。
4.4 文卷查询
这一条的编写针对具有查询能力的软件,内容包括:同数据库查询有关的初始化、准备、及处理所需要的详细规定,说明查询的能力、方式,所使用的命令和所要求的控制规定。
4.5 出错处理和恢复
列出由软件产生的出错编码或条件以及应由用户承担的修改纠正工作。指出为了确保再启动和恢复的能力,用户必须遵循的处理过程。
4.6 终端操作
当软件是在多终端系统上工作时,应编写本条,以说明终端的配置安排、连接步骤、数据和参数输入步骤以及控制规定,说明通过终端操作进行查询、检索、修改数据文卷的能力、语言、过程以及辅助性程序等。

willie 2003-06-03
  • 打赏
  • 举报
回复
肯定有区别的
gotothere 2003-06-03
  • 打赏
  • 举报
回复
用户手册主要是告诉用户怎么使用,参考一下文档模板就可以了
alwaysalfa 2003-05-30
  • 打赏
  • 举报
回复
http://www.uml.net.cn/bzgf/bzgf19.htm
这是用户手册的规范。实际上在写用户手册不需要如此详细。具体看客户对用户手册的需要了。最近写用户手册的时候发现,客户的需求才是重要的。
可以看一下IE浏览器的帮助文件,在写实际过程中,思路很有帮助。
testpb 2003-05-30
  • 打赏
  • 举报
回复
下载别的软件看吧!
ghostcool2 2003-05-30
  • 打赏
  • 举报
回复
有没有些书面的资料?
ghostcool2 2003-05-30
  • 打赏
  • 举报
回复
请问楼上的 用户手册和帮助文档有没有区别?
freeprogramer 2003-05-29
  • 打赏
  • 举报
回复
这要看用户的计算机水平而定怎么写了
shuker 2003-05-29
  • 打赏
  • 举报
回复
用户手册很重要啊
公司最好有专人负责写
wangyanqiu 2003-05-29
  • 打赏
  • 举报
回复
首先要分清楚用户手册与需求的区别,
手册就是用户照你的说明逐步进行,对于重要的详细说明,简单一带就过!
首先有大概认识,然后对每个步骤详细说明。
要把自己当成傻子,这样会更容易发现问题。
同时写完随便让别人一看就会有很多问题的!


5,227

社区成员

发帖
与我相关
我的任务
社区描述
软件工程/管理 质量管理/软件测试
功能测试压力测试安全性测试 个人社区 湖南省·长沙市
社区管理员
  • 软件测试
  • 虫无涯
  • 小博测试成长之路
加入社区
  • 近7日
  • 近30日
  • 至今
社区公告

欢迎大家加入到软件测试的社区,在这里,希望大家勇于发表自己的看法,欢迎大家分享自己在软件测试工作过程中遇到的问题以及工作经验分享。

1.想转行的小伙伴,遇到问题没有及时回复的,可以私聊小博进行反馈

2.大家对社区有好的建议,都可以在社区发帖进行反馈

推荐大家学习的软件测试入门笔记:软件测试入门学习笔记

试试用AI创作助手写篇文章吧