软件用户手册编写指南
1引言 |
||
1.1编写目的 |
||
1.2背景 |
||
1.3定义 |
||
1.4参考资料 |
||
2用途 |
||
2.1功能 |
||
2.2性能 |
||
2.2.1精度 |
||
2.2.2时间特性 |
||
2.2.3灵活性 |
||
2.3安全保密 |
||
3运行环境 |
||
3.1硬设备 |
||
3.2支持软件 |
||
3.3数据结构 |
||
4使用过程 |
||
4.1安装与初始化 |
||
4.2输入 |
||
4.2.1输入数据的现实背景 |
||
4.2.2输入格式 |
||
4.2.3输入举例 |
||
4.3输出对每项输出作出说明 |
||
4.3.1输出数据的现实背景 |
||
4.3.2输出格式 |
||
4.3.3输出举例 |
||
4.5出错处理和恢复 |
||
4.6终端操作 |
用户手册(GB8567——88)
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终端操作
当软件是在多终端系统上工作时,应编写本条,以说明终端的配置安排、连接步释、数据和参数输入步骤以及控制规定.说明通过终端操作进行查询、检索、修改数据文卷的能力、语言、过程以及辅助性程序等。
软件用户手册编写指南相关推荐
- 软件测试报告编写指南
第1章 引言 1.1 编写目的 本测试报告的具体编写目的,指出预期的读者范围. 实例:本测试报告为XXX项目的测试报告,目的在于总结测试阶段的测试情况以及分析测试结果,描述系统是 ...
- 【Linux入门学习之】Ubuntu常用软件 速配指南之软件参考
[Linux入门学习之]Ubuntu常用软件 速配指南之软件参考 本文定位:作为速配指南的补充,列出国内用户比较常用的软件.请将论坛软件推荐版块的内容逐步转移至wiki,而非本文. 本文作用:为新手指 ...
- CCleaner 垃圾文件清理规则 编写指南
以下内容的英文版本来源于 CCleaner 官方论坛,仅供参考.欢迎大家编写并分享针对常用国产软件的垃圾文件清理规则! 需要说明的是规则文件(Winapp2.ini)需和程序文件放于同一文件夹下,才能 ...
- 方案:软件系统测试工作指南
软件系统测试工作指南 编者说明: 这是一个系统测试的工作指南.你可以根据该文档,结合实际进行修改. 1. 简介 1.1 目的 本文详细阐述了系统测试的类型以及各个类型的基本测试方法,指导项目开发人员进 ...
- 测试用例编写指南
测试用例编写指南 目录 1 目的 2 适用范围 3 测试设计依据 4 测试用例编写步骤 5 测试用例编写要素 6 测试用例划分原则 6.1 测试需求划分 6.2 测试用例划分 7 测试用例编写要求 8 ...
- bash 与 shell脚本编写指南
bash 与 shell脚本编写指南 bash 与 shell脚本编写指南 bash基本命令 man与info命令 遍历目录命令 文件与目录列表命令 处理文件相关命令 处理目录命令 查看文件内容 通过 ...
- 30条HTML代码编写指南 for入门者
本文总结了30条html代码编写指南,只要在编写HTML代码的过程中牢记它们,灵活运用,你一定会写出一手漂亮的代码,早日迈入专业开发者的行列. 1. 一定要闭合HTML标签 在以往的页面源代码里,经常 ...
- HTML语言编写指南
作者: 阮一峰 日期: 2009年5月17日 制作网页的第一步,就是学会编写HTML语言. HTML是一种标签语言,通过在内容上附加各种标签,达到在浏览器中正确展示的目的.正确地编写HTML,不仅是制 ...
- outlook html阅读,Html Email 邮件html页编写指南
前言 写过邮件的html的童学应该都知道,邮件的html一般都用table来布局,为什么呢?原因是大多数的邮件客户端(比如Outlook和Gmail),会过滤HTML设置,让邮件面目全非. 经过多次的 ...
最新文章
- Linux下vsftpd服务器
- 小学六年级下册计算机计划,小学六年级科学下册教学计划(通用5篇)
- pytorch笔记:Dataloader
- N - Dragon Balls(并查集+深度的意义
- [angularjs]初学小记1
- mysql自带的全文索引_MySQL创建全文索引分享
- 在layoutsubviews中设置子控件的frame,保证执行alpha和frame动画流畅度
- Lua基础篇-1 :什么是 Lua 语言?
- .net工具类 获取枚举类型的描述
- 告知书页面html样式,纯CSS实现的三种通知栏滚动效果
- sql从某行开始获取数据
- 交出20分钟后就得到面试通知的一份答卷
- 计算机网络管理员基础pdf,复习题计算机网络管理员高级.pdf
- VC++的Unicode编程
- PMSM学习笔记1——永磁同步电机的工作原理与数学模型
- 自制低成本3D激光扫描测距仪(3D激光雷达),第二部分
- Jenkins的详细安装及使用
- vivo联合天猫超品日共同打造X70系列城市影像馆
- MIT 18.02 多变量微积分总结(Part I)
- 计算机主板用塑料做的好吗,旧电脑零件千万别扔 重新利用竟还能做出这么多新设备...
热门文章
- 江苏计算机自考考哪个学校,江苏2020年有哪些自考院校
- springboot 图片映射404问题
- oracle的dba_ segment,Dba_segments详解
- 08_Python算法+数据结构笔记-二叉搜索树查询/删除-AVL树旋转/插入/应用-贪心算法
- Android架构组件Room功能详解,面试必问
- Gradle 的下载安装教程
- 配置vsftpd 服务器
- 【ybt金牌导航8-7-1】数对统计 / 关于莫比乌斯函数的少量内容
- 可视化大屏设计_最高效的大屏展示不只是酷炫
- No subdirectories found for mandatory directory location ‘file: /config/*/‘