当前位置:文档之家› 某软件公司用户手册编制规范标准

某软件公司用户手册编制规范标准

密级:机密用户手册编制规范
V1.0
浪潮集团山东通用软件有限公司
目录
文档类别使用对象 (3)
1.引言 (5)
1.1目的 (5)
1.2范围 (5)
1.3术语定义 (6)
1.4参考资料 (6)
1.5版序控制记录 (6)
1.6版本更新记录 (6)
2.编制大纲 (8)
2.1编写要求 (8)
2.2文档分类 (10)
2.3用户使用手册编制大纲 (11)
2.3.1 前言 (12)
2.3.2 功能 (13)
2.3.3 附录 (14)
2.4用户安装手册编制大纲 (14)
2.4.1 前言 (15)
2.4.2 单机版的安装及配制 (15)
2.4.3 网络版的安装及配制 (16)
2.4.3 附录 (17)
2.5系统管理员手册编制大纲 (17)
3.编写原则 (18)
4.审核鉴定 (20)
文档类别使用对象
文档类别
该文档是为浪潮通用软件公司的产品提供一个用户手册编写规范。

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

1.引言
1.1目的
本文档是为公司产品的文档编写提供规范说明,其目的是:
1、为用户提供各种类型的文档,以供用户参阅和培训之
用。

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

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

1.3术语定义
1.4参考资料
国强财务软件6.0产品用户手册编写指南V1.3
1.5版序控制记录
1.6版本更新记录
*A - 增加M - 修改D - 删除
2.编制大纲
2.1 编写要求
1.应该用统一的风格、确定的方法描述产品提供的所有功能。

2.统一采用编制工具Word进行编写。

3.描述之后的功能,应该具有如下的特点:
1)对于每一个功能的描述应该完整,从对应的实际业务、产品提供的相应功能以及对应此功能的一些相关操作等方
面进行描述。

2)对于术语的描述分系统术语和基本概念,系统术语在整个系统的含义是统一的,在前言部分描述;基本概念在各个
章节进行描述。

对于每个功能的描述不能有歧义。

3)语言要简洁明快,表达准确。

4.编写格式应统一:
1)封面的设计根据编写部门自己的需求,但应有的图标,封底应有公司的名称、地址、电话、传真、网
址和E-mail 地址;
2)目录用WORD97自动生成,采用正式格式,显示三
级标题,页码右对齐,字体用小四号宋体;目录起始页第
一行正中为“目录”二字,字体为四号加黑宋体。

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

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

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

2.2 文档分类
名称说明
用户使用手册1、目的:用户认真阅读本手册,可以快速、方便的使用本系统的功能。

2、作用:培训和参考的作用。

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

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

2、作用:帮助用户正确地安装使用软件。

2.3 用户使用手册编制大纲
2.3.1 前言
提供手册的概述,在此可以说明编写这份手册的目的、指出本书适用的读者。

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

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

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

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

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

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

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

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

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

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

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

2)操作步骤:用鼠标选择相应的功能,进入相应的界面,进行功能键以及栏目的介绍。

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

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

2.4 用户安装手册编制大纲
2.4.1 前言
指明编制该手册的目的,指明预期的读者,简介该系统软件的操作系统,数据库,c/s体系结构,界面特点,以及技术特色。

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

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

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

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

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

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

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

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

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

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

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

另外,还应简单介绍一下安装网络和数据库所需注意事项和可参考的工具书。

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

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

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

附录2
参考资料,应写上书名、作者、出版社
2.5 系统管理员手册编制大纲
前言部分概述系统管理员应该完成的任务,系统管理员应具备的知识,一个称职的系统管理员的所具有的素质。

参考资料:应注明都参考了那些资料,写上书名、作者及出版社。

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

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

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

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

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

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

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

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

相关主题