用户手册编写规范

用户手册编写规范
密级：机密用户手册编制规范 V
1.01999 年10 月20 日浪潮集团山东通用软件有限公司浪潮通软公司用户手册编写规范1 目录文档类别使用对象 .21.引言 .31.1 目的31.2 范围31.3 术语定义31.4 参考资料31.5 版序控制记录31.6 版本更新记录4
2.编制大纲 .52.1 编写要求52.2 文档分类62.3 用户使用手册编制大纲62.
3.1 前
言 .72.3.2 功能 .72.3.3 附录 .82.4 用户安装手册编制大纲82.4.1 前言 .92.4.2 单机版的安装及配制 .92.4.3 网络版的安装及配制 .92.4.3 附录 .102.5 系统管理员手册编制大纲103.编写原则 .114.审核鉴定 .11 浪潮通软公司用户手册编写规范2 文档类别使用对象文档类别该文档是为浪潮通用软件公司的产品提供一个用户手册编写规范。

使用对象该文档使用对象为浪潮通用软件公司参与文档编制工作的人员,包括设计人员.编程人员.文档编制人员以及其他参与文档工作的成员。

浪潮通软公司用户手册编写规范31.引言1.1 目的本文档是为公司产品的文档编写提供规范说明，其目的是：1.为用户提供各种类型的文档，以供用户参阅和培训之用。

2.提供相应的配套资料，辅助软件推向市场。

1.2 范围本文档提供公司产品用户手册的编制类型.编制大纲.编制风格.编制顺序以及用于编制人员最后进行的审核。

1.3 术语定义1.4 参考资料国强财务软件6.0 产品用户手册编写指南 V
1.31.5 版序控制记录版序状态拟稿审核批准发布日期1.0 管理过程改善部浪潮通软公司用户手册编写规范41.6 版本更新记录 *A 修改 Dmail 地址；2）目录用 WORD97 自动生成，采用正式格式，显示三级标题，页码右对齐，字体用小四号宋体；目录起始页第一行正中为“目录”二字，字体为四号加黑宋体。

3）正文的章.节格式用 MS WORD*的标题格式，段内的字体应保持字体统一，用小四号宋体。

但特殊强调的需引起读者注意的条目，可用其它字体。

4）正文的页眉用五号宋体，格式如下：章节名称正文页码设置：位置为页面底端（页脚），对齐方式为外侧。

浪潮通软公司用户手册编写规范62.2 文档分类名称说明用户使用手册1.目的：用户认真阅读本手册,可以快速.方便的使用本系统的功能。

2.作用：培训和参考的作用。

3.使用对象：使用本产品的用户以及培训本产品的市场.服
务人员。

安装手册1.目的：用户能正确地安装软件。

2.作用：帮助用户正确地安装使用软件。

3.使用对象：用户。

系统管理员手册1.目的：对系统管理员提供的使用说明。

2.作用：使系统管理员对系统有一个大概的了解，提高系统
管理员的工作效率，减少系统出错机率；减少服务人员的工作
量。

3.使用对象：用户2.3 用户使用手册编制大纲
目录
第一章前言1.1 内容简介1.2 主要功能1.3 操作流程1.4 基本概念
第二章功能12.1 使用流程2.2 具体描述2.2.1 进行此功能的业务介绍2.2.2 操作步骤2.2.3 功能键.以及项目说明2.2.4 举例2.2.5 特殊提示及注意事项。

浪潮通软公司用户手册编写规范7第 N 章功能 n 附录：
附录1 常用功能介绍附录2 技术支持2.3.1 前言提供手册的概述,在此可以说明编写这份手册的目的.指出本书适用的读者。

1.内容简介简单地介绍编写的背景，系统适用的用户。

2.主要功能是对该系统软件进行的简单讲解，所完成的功能介绍。

3.操作流程操作流程的说明：应全面模拟用户操作，从安装.进入.初始化.到用户具体操作的整个流程进行描述。

4.基本概念基本概念：说明定义的术语在本手册的含义。

步骤说明：针对操作流程的每一步进行说明。

如果在使用说明中有相应的解释，应指明用户查找的位置。

2.3.2 功能这部分包括用户使用的所有功能,这是用户使用手册的最大最重要的部分，要详细的描述。

1.使用流程描述具体功能的使用顺序。

如果功能之中有分类，比如，有些功能用户用不到，有些用得到，就要分开写流程。

2.具体描述描述顺序是按照使用流程的每一步进行的。

1）进行此功能的业务介绍：对此功能进行简单的介绍,说明所能完成的功能。

2）操作步骤：用鼠标选择相应的功能,进入相应的界面,进行功能键以及栏浪潮通软公司用户手册编写规范8 目的介绍。

3）举例：针对某一功能,对于一些比较难的问题,应该进行举例说明。

4）特殊提示及注意事项在使用说明中，每一部分都会归纳一些问题,需要提示用户或者让用户注意，应按照以下规定的格式进行编写：格式：字体采用仿宋字，字号采用五号字举例如下: 注意：凭证制作人和凭证复核人不能是同一个人2.3.3 附录对一些在正文中描述不够详尽的地方，可在附录中进行补充；或是用户经常遇到的问题及问题解答也可放在附录中。

2.4 用户安装手册编制大纲
目录
第一章前言1.1 内容简介1.2 使用约定
第二章单机版的安装及配置2.1 运行环境2.2 系统软件的安装2.3 安装后的系统配置
第三章网络版的安装及配置2.1 运行环境2.2 系统软件的安装2.3 安装后的系统配置附录附录1 安装过程提供的技术支持附录2 参考资料浪潮通软公司用户手册编写规范92.4.1 前言指明编制该手册的目的，指明预期的读者，简介该系统软件的操作系统，数据库，c/s 体系结构，界面特点，以及技术特色。

1.内容简介：介绍本书提供的几个部分：简单介绍几个部分的大概内容。

2.使用约定提示：提供安装过程的一些好的方法。

注意：安装过程中特殊注意的地方。

警告：指出危险动作或状态，不注意这些，会对你的安装造成破坏。

2.4.2 单机版的安装及配制1.运行环境1）硬件环境：列出运行本软件所要求的硬设备的最小配制。

微机要求包括型号，内存，硬盘。

显示器要求：以及一些其他的设备：I/O 设备2）软件环境：列出运行本软件所需要的支持软件操作系统程序语言以及数据库管理系统2.安装单机版的系统软件1）简单介绍单机版打包光盘定义以及内容。

2）介绍该软件单机版的安装步骤：3.安装后的系统配置介绍该软件安装完之后对配置信息的查看，以确定是否需要改动.是否是最优配置；介绍系统配置的路径.以及在何处可以用得上系统配置。

另外，运行软件的时候，有时会出现数据库联结不成功。

在这部分介绍会有几种原因，并分别简述。

2.4.3 网络版的安装及配制1.运行环境除了对硬件环境提出要求外，对软件环境的要求应列出运行本软件所需的操作系统.与操作系统兼容的网络环境.程序语言以及数据库管理系统。

浪潮通软公司用户手册编写规范10 另外，还应简单介绍一下安装网络和数据库所需注意事项和可参考的工具书。

2.安装网络版的系统软件1）介绍该软件单机版的安装步骤：2）如何进行系统环境配置；3）数据库的默认用户及口令等。

3.安装后的系统配置2.
4.3 附录附录1 安装过程提供的技术支持。

在此说明技术支持的几种方式，及常见安装疑难解答。

附录2 参考资料，应写上书名.作者.出版社2.5 系统管理员手册编制大纲目录前言
第一章硬件知识概述1.1 网卡的安装与配置1.2 网络问题的诊断1.3 站点增加时的操作1.4 。

第二章网络操作系统1.1 网络操作系统的操作1.2 网络操作系统的维护1.3 网络操作系统的配置1.4 。

第三章数据库管理1.1 数据库的安装及维护1.2 数据库的配置1.3 。

第四章系统软件的配置4.1 。

4.2 。

前言部分概述系统管理员应该完成的任务，系统管理员应具备的知识，一浪潮通软公司用户手册编写规范11 个称职的系统管理员的所具有的素质。

参考资料：应注明都参考了那些资料，写上书名.作者及出版社。

3.编写原则编写原则是指是参与文档编写工作的人员如何编写文档，编写需具备的过程。

软件的形成过程是经过需求分析.软件设计阶段.编程阶段.测试阶段. 运行与维护阶段，各个阶段都必须有相应的文档编制。

用户手册是最终提供给用户的参考资料，必须结合需求分析以及软件的生命周期的各个过程来进行编写。

首先，文档编写主管应在文档编制需求提出后编写文档计划(文档编制需求)并把它分发给全体相关人员，作为文档重要性的具体依据和管理部门文档工作责任的备忘录。

文档计划一般包括以下几方面内容：1）列出应编制文档的目录；2）提示编制文档应参考的标准；3）指定文档管理员；4）提供编制文档所需要的条件，落实文档编写人员.主管和所需经费以及编制工具等；5）明确保证文档质量的方法，为了确保文档内容的正确性.合理性，
应采取一定的措施，如评审.审稿.鉴定等；6）绘制进度表，以图表形式列出各阶段应产生的文档.编制人员.编制主管.编制日期.完成日期.评审日期等。

其次文档编写人员应有一定的文字表达能力，而且应明确用户的真正需求，真正从用户的角度考虑问题；文档编写人员还应与程序员有相应的交流，弄清程序员的编写步骤，各个功能的使用顺序，弄清各个功能对应的业务。

最后，文档编写人员应按照编写大纲认真编写文档。

4.审核鉴定保证文档的质量以及文档内容的正确性.合理性，应对用户手册进行评审和鉴定工作，提出改进意见，以利整个文档质量的提高。