软件用户手册编写指南

摘自:http://blog.csdn.net/lemonran/article/details/7278813

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终端操作当软件是在多终端系统上工作时,应编写本条,以说明终端的配置安排、连接步释、数据和参数输入步骤以及控制规定.说明通过终端操作进行查询、检索、修改数据文卷的能力、语言、过程以及辅助性程序等。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,390评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,821评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,632评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,170评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,033评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,098评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,511评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,204评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,479评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,572评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,341评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,213评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,576评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,893评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,171评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,486评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,676评论 2 335

推荐阅读更多精彩内容