某软件公司用户手册编制规范.docx

《某软件公司用户手册编制规范.docx》由会员分享，可在线阅读，更多相关《某软件公司用户手册编制规范.docx（18页珍藏版）》请在第一文库网上搜索。

1、某软件公司用户手册编制规范用户手册编制规范V1.0浪潮集团山东通用软件有限公司目录文档类别使用对象21 .引言41. 1目的412范围413术语定义514参考资料515版序操纵记录51. 6版本更新记录52.编制大纲72. 1编写要求72. 2文档分类92. 3用户使用手册编制大纲102. 3.1前言112. 3.2功能123. 3.3附录132. 4用户安装手册编制大纲132.4.1前言142.4.2单机版的安装及配制.142.4.3网络版的安装及配制.152.4.3附录162 .5系统管理员手册编制大纲163 .编写原则174 .审核鉴定18文档类别使用对象文档类别该文档是为浪潮通用软件公

2、司的产品提供一个用户手册编写规范。使用对象该文档使用对象为浪潮通用软件公司参与文档编制工作的人员,包含设计人员、编程人员、文档编制人员与其他参与文档工作的成员。1 .引言1.1 目的本文档是为公司产品的文档编写提供规范说明，其目的是：1、 为用户提供各类类型的文档，以供用户参阅与培训之用。2、 提供相应的配套资料，辅助软件推向市场。12范围本文档提供公司产品用户手册的编制类型、编制大纲、编制风格、编制顺序与用于编制人员最后进行的审核。1.3术语定义14参考资料国强财务软件6.O产品用户手册编写指南V1.31.5版序操纵记录版序状态拟稿审核批准公布日期1.0管理过程改善部1. 6版本更新记录*A

3、-增加M-修改D-删除版本/修订版修改页码修改记录修改人日期1.0初始版本99/102.编制大纲2. 1编写要求1 .应该用统一的风格、确定的方法描述产品提供的所有功能。2 .统一使用编制工具Word进行编写。3 .描述之后的功能，应该具有如下的特点：1)关于每一个功能的描述应该完整，从对应的实际业务、产品提供的相应功能与对应此功能的一些有关操作等方面进行描述。2)关于术语的描述分系统术语与基本概念，系统术语在整个系统的含义是统一的，在前言部分描述；基本概念在各个章节进行描述。关于每个功能的描述不能有歧义。3)语言要简洁明快，表达准确。4 .编写格式应统一：圈也鞠荻1) 封面的设计根据编写部门

4、自己的需求，但应有的图标，封底应有公司的名称、地址、电话、传真、网址与E-mai1地址；2) 目录用W0RD97自动生成，使用正式格式，显示三级标题，页码右对齐，字体用小四号宋体；目录起始页第一行正中为“目录”二字，字体为四号加黑宋体。3) 正文的章、节格式用MSWoRD*的标题格式，段内的字体应保持字体统一，用小四号宋体。但特殊强调的需引起读者注意的条目，可用其它字体。4) 正文的页眉用五号宋体，格式如下:章节名称正文页码设置：位置为页面底端（页脚），对齐方式为外侧。2.2文档分类名称说明用户使用1、目的：用户认真阅读本手册,能够快速、方便手册的使用本系统的功能。2、作用：培训与参考的作用。

5、3、使用对象：使用本产品的用户与培训本产品的市场、服务人员。安装手册1、目的：用户能正确地安装软件。2、作用：帮助用户正确地安装使用软件。3、使用对象：用户。系统管理员手册1、目的：对系统管理员提供的使用说明。2、作用：使系统管理员对系统有一个大概的熟悉，提高系统管理员的工作效率，减少系统出错机率；减少服务人员的工作量。3、使用对象：用户2.3用户使用手册编制大纲目录第一章前言1. 1内容简介12要紧功能1. 3操作流程2. 4基本概念第二章功能13. 1使用流程2. 2具体描述2. 2.1进行此功能的业务介绍2. 2.2操作步骤2. 2.3功能键、与项目说明2. 2.4举例2. 2.5特殊提

6、示及注意事项Oooooooooooooooooooo第N章功能n附录：附录1常用功能介绍附录2技术支持2. 3.1前言提供手册的概述,在此能够说明编写这份手册的目的、指出本书适用的读者。1、内容简介简单地介绍编写的背景，系统适用的用户。2、要紧功能是对该系统软件进行的简单讲解，所完成的功能介绍。3、操作流程操作流程的说明：应全面模拟用户操作，从安装、进入、初始化、到用户具体操作的整个流程进行描述。4、基本概念基本概念：说明定义的术语在本手册的含义。步骤说明：针对操作流程的每一步进行说明。假如在使用说明中有相应的解释，应指明用户查找的位置。2. 3.2功能这部分包含用户使用的所有功能,这是用户使

7、用手册的最大最重要的部分，要全面的描述。1、使用流程描述具体功能的使用顺序。假如功能之中有分类，比如，有些功能用户用不到，有些用得到，就要分开写流程。2、具体描述描述顺序是按照使用流程的每一步进行的。D进行此功能的业务介绍：对此功能进行简单的介绍,说明所能完成的功能。2) 操作步骤：用鼠标选择相应的功能,进入相应的界面,进行功能键与栏目的介绍。3) 举例：针对某一功能,关于一些比较难的问题,应该进行举例说明。4) 特殊提示及注意事项在使用说明中，每一部分都会归纳一些问题，需要提示用户或者者让用户注意，应按照下列规定的格式进行编写：格式：字体使用仿宋字，字号使用五号字举比如下:注意：-凭证制作大

8、与-凭证复核大不能是同一一个大2.3.3附录对一些在正文中描述不够详尽的地方，可在附录中进行补充;或者是用户经常遇到的问题及问题解答也可放在附录中。2.4用户安装手册编制大纲目录第一章前言1.1内容简介1. 2使用约定第二章单机版的安装及配置2. 1运行环境2.2系统软件的安装2. 3安装后的系统配置第三章网络版的安装及配置2.1 运行环境2. 2系统软件的安装3. 3安装后的系统配置附录附录1安装过程提供的技术支持附录2参考资料2. 4.1前言指明编制该手册的目的，指明预期的读者，简介该系统软件的操作系统，数据库，c/s体系结构，界面特点，与技术特色。1、内容简介：介绍本书提供的几个部分：简

9、单介绍几个部分的大概内容。2、使用约定提示：提供安装过程的一些好的方法。注意：安装过程中特殊注意的地方。警告：指出危险动作或者状态，不注意这些，会对你的安装造成破坏。3. 4.2单机版的安装及配制1、运行环境1）硬件环境：列出运行本软件所要求的硬设备的最小配制。微机要求包含型号，内存，硬盘。显示器要求：与一些其他的设备：I/O设备2）软件环境：列出运行本软件所需要的支持软件操作系统程序语言与数据库管理系统2、安装单机版的系统软件1）简单介绍单机版打包光盘定义与内容。2）介绍该软件单机版的安装步骤：3、安装后的系统配置介绍该软件安装完之后对配置信息的查看，以确定是否需要改动、是否是最优配置；介绍

10、系统配置的路径、与在何处能够用得上系统配置。另外，运行软件的时候，有的时候会出现数据库联结不成功。在这部分介绍会有几种原因，并分别简述。2.4.3网络版的安装及配制1、运行环境除了对硬件环境提出要求外，对软件环境的要求应列出运行本软件所需的操作系统、与操作系统兼容的网络环境、程序语言与数据库管理系统。另外，还应简单介绍一下安装网络与数据库所需注意事项与可参考的工具书。2、安装网络版的系统软件1）介绍该软件单机版的安装步骤：2）如何进行系统环境配置；3）数据库的默认用户及口令等。3、安装后的系统配置2.4.3附录附录1安装过程提供的技术支持。在此说明技术支持的几种方式,及常见安装疑难解答。附录2

11、参考资料，应写上书名、作者、出版社2.5系统管理员手册编制大纲目录前百第一章硬件知识概述1.1网卡的安装与配置12网络问题的诊断1.3站点增加时的操作1 .4OOO第二章网络操作系统11网络操作系统的操作1.2 网络操作系统的保护1.3 网络操作系统的配置1 .4OOO第三章数据库管理11数据库的安装及保护1.2 数据库的配置1.3 OOO第四章系统软件的配置4. 1OOOOOO42OOOOOO前言部分概述系统管理员应该完成的任务，系统管理员应具备的知识，一个称职的系统管理员的所具有的素养。参考资料：应注明都参考了那些资料，写上书名、作者及出版社。3 .编写原则编写原则是指是参与文档编写工作的

12、人员如何编写文档，编写需具备的过程。软件的形成过程是通过需求分析、软件设计阶段、编程阶段、测试阶段、运行与保护阶段，各个阶段都务必有相应的文档编制。用户手册是最终提供给用户的参考资料，务必结合需求分析与软件的生命周期的各个过程来进行编写。首先,文档编写主管应在文档编制需求提出后编写文档计划(文档编制需求)并把它分发给全体有关人员，作为文档重要性的具体根据与管理部门文档工作责任的备忘录。文档计划通常包含下列几方面内容：1) 列出应编制文档的目录；2) 提示编制文档应参考的标准；3) 指定文档管理员；4) 提供编制文档所需要的条件，落实文档编写人员、主管与所需经费与编制工具等；5) 明确保证文档质量的方法，为了确保文档内容的正确性、合理性，应采取一定的措施，如评审、审稿、鉴定等；6) 绘制进度表，以图表形式列出各阶段应产生的文档、编制人员、编制主管、编制日期、完成日期、评审日期等。其次文档编写人员应有一定的文字表达能力，而且应明确用户的真正需求，真正从用户的角度考虑问题；文档编写人员还应与程序员有相应的交流，弄清程序员的编写步骤，各个功能的使用顺序，弄清各个功能对应的业务。最后，文档编写人员应按照编写大纲认真编写文档。4 .审核鉴定保证文档的质量与文档内容的正确性、合理性，应对用户手册进行评审与鉴定工作，提出改进意见，以利整个文档质量的提高。