用户手册编写模板

合集下载
  1. 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
  2. 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
  3. 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。

密级:内部公开

{ 项目名称}

用户手册编写指南

文件修订记录

文件审批信息

注:蓝色斜体部分为注释或举例,实际使用时请去掉。

版权声明

[版权声明是保护我们所开发软件的产权、不使公司利益受到损害的一种方式。在版权声明中应该包括以下内容:

1. 对我们所提供的软件及用户手册的保护声明

2. 对我们的软件及商标所有权的声明

3. 对我们的用户手册中所提到的各种商标的版权声明

4. 我们不对用户因为使用我们的软件所造成的损失负责的声明]

前言

文档目标

通过阅读该用户手册,用户应该或能够达到什么目标。

阅读对象

说明谁应该阅读本手册,或谁应该阅读本手册的哪些部分。

关于本手册

如果本系统的用户手册(包括管理员手册、参考手册等)由多份文档组成,则首先应该分别简要介绍这些手册的情况。然后分别介绍本手册在每一章所要描述的内容。有助于用户阅读和理解本手册的相关文档资源,也可以在本段中特别指明。

文档约定

说明文档中字体体例,用什么字体代表什么意义。例如:黑体(粗)代表命令,黑体(常规)代表命令参数等等。

说明文档中的符号代表何种意义。例如:代表提醒等。

缩略语和术语

列出本文档涉及的缩略语和术语,并扼要解释。如果篇幅较大,则可以以附录和引用文件的形式给出。

如何获得最新版本

说明获得本手册最新版本的途径。

用户反馈

列出用户通过什么途径,提交对产品手册的意见。

目录

1 简介 (6)

1.1描述 (6)

1.1.1 的用途 (6)

1.1.2 系统主要特性 (6)

1.1.3 不能胜任的工作(本条可选) (6)

1.2安装、运行环境 (6)

1.2.1 软件环境 (6)

1.2.2 硬件环境 (6)

1.2.3 其它 (6)

1.3问题报告和获得帮助 (7)

2 快速指南(本章可选) (7)

3 系统安装 (7)

3.1 WINDOWS 2003下安装(用实际的操作系统名称来代替标题中的操作系统名称)7

3.1.1 安装前准备 (7)

3.1.2 安装 (7)

3.1.3 安装验证测试(本条可选) (8)

3.2S OLARIS下安装(用实际的操作系统名称来代替标题中的操作系统名称)8

3.2.1 安装前准备 (8)

3.2.2 安装 (8)

3.2.3 正确安装测试(本条可选) (8)

3.3R ED H AT L INUX AS4下安装(用实际的操作系统名称来代替标题中的操作系统名称)

(8)

4 用户界面(本章可选) (8)

4.1简介 (9)

4.2开始使用系统 (9)

4.3主窗口 (9)

4.4菜单 (9)

4.4.1 “文件”(File)菜单 (9)

4.4.2 “编辑”(Edit)菜单 (9)

4.4.3 (9)

4.4.4 “帮助”(Help)菜单 (9)

5 使用 (9)

5.1用户管理 (10)

5.1.1 用户登录 (10)

5.1.2 新建用户 (10)

5.1.3 删除用户 (10)

5.2数据管理 (10)

6 <视具体情况,添加更多的章节来说明系统。例如:命令参考、系统数据格式说明等> (10)

7 常见问题解决 (10)

8 附录 (10)

8.1附录1-列表(本条可选) (10)

8.1.1 表格列表 (10)

8.1.2 插图列表 (11)

8.1.3 示例列表 (11)

8.2附录2-参考文档 (11)

1简介

1.1描述

1.1.1的用途

描述系统的用途,例如用于社区信息管理,诸如此类。

1.1.2系统主要特性

扼要描述系统的主要特性(features),例如支持多少种操作系统、支持多少个用户、支持同时多少个并发等等。

1.1.3不能胜任的工作(本条可选)

描述系统不具备的能力,防止用户误用。例如用户可能会用一个网络包分析和包生成软件来实施路由功能,显然这不是应用程序设计的本意。

1.2安装、运行环境

描述系统安装、运行所需的环境。如果安装和运行的环境不一致,则需要单独说明。

1.2.1软件环境

列出系统安装、运行所需的操作系统以及其他辅助的应用程序,例如Windows2003、SQL Server,诸如此类。

1.2.2硬件环境

列出系统安装、运行所需的硬件环境,例如主机的数量、主机的配置(CPU、内存、硬盘、网卡)以及外设(打印机、扫描仪、绘图仪),诸如此类。

1.2.3其它

列出系统安装、运行所需的其它要求。

1.3问题报告和获得帮助

说明用户反映系统问题以及获得帮助的途径,例如email、电话、在线帮助,诸如此类。

2快速指南(本章可选)

以一个或几个简单的功能为例,快速地把操作流程演示一遍,让用户对系统的界面和功能有一个直观的印象,减少陌生感。本段篇幅应该尽量短少,几页就可能收到不错的效果。描述的风格以用户界面截屏图以及菜单操作为主。

3系统安装

说明系统的安装流程。如果系统的安装前的准备工作对于不同的操作系统有特殊的要求,那么就应该按不同的操作系统分别列出。例如:

3.1. W indows 2003

3.2. S olaris

3.3. R edHat Linux AS4

……

3.1windows 2003下安装(用实际的操作系统名称来代替标题中的

操作系统名称)

3.1.1安装前准备

说明系统安装之前需要进行的准备工作,例如检查操作系统和应用程序的版本、硬盘的空间、用户在系统中的权限、环境变量的设置,诸如此类。

3.1.2安装

详细说明系统的整个安装过程,内容包括:

编译(本条可选)。如果系统是以源代码方式提供的,则说明如何编译成可执行的安装程序。

安装命令。例如菜单命令、命令行命令以及脚本命令等等。

相关文档
最新文档