编写用户帮助/操作手册指南
背景:
用户操作手册是一份指导用户使用产品或服务的重要手册。 一个新系统,需要写用户操作手册,该从何下笔?本篇是一篇教你编写用户帮助/操作手册的指南~
首先,先来看一个反例 :
这个是我入职的时候,我们公司对ERP系统已有的一个用户操作手册,这个用户操作手册详细的讲明了每一个页面的操作使用说明。
但是看完了之后我还是不太会快速上手使用;倒也不是说我的理解能力薄弱,而是 用户操作手册内容太多太多,没有提炼出重点,以及主流程是哪些 。无法完全理解这个系统。
编写用户帮助/操作手册指南
于是,当我独立负责我们公司新系统测试时候,测试后期需要写新系统的用户帮助文档时,我决定按照我的想法来写。 这也是我第一次编写用户帮助/操作手册。
这个是我写的用户帮助/操作手册。
写操作文档需要做以下步骤:
确定受众:首先,必须明确手册的主要读者群体,即使用您的产品或服务的用户。 这将有助于您确定要使用的文档风格和语言。
譬如我们ERP系统使用受众是:公司内部员工(也可以当成普通用户)描述时尽可能的简单易懂,并且在第一个目录下的文章中写清楚,这个系统是什么,有什么用,我用这个系统能够有什么好处,这个系统有什么功能,它能帮到我什么,能帮我解决什么问题…等,让初次使用的用户留下一个印象,这个系统/工具能否解决他的痛点,是他想要的,才是让他继续使用的动力~
列出步骤,快速上手:列出用户如何快速上手的关键步骤,将每个步骤分成易于理解的简单步骤,以确保用户能够轻松地按照手册中的步骤使用~
层次也要清晰,可以利用文档编辑工具的添加子层级、添加文档、引用链接等,不要把内容都堆到一起;一级标题、二级标题,加粗字体都很有必要。
使用简单的语言:避免使用技术术语或复杂的语言。 保持语言重点简单明了,使用户能够轻松理解。
结合可视化:在手册中添加图片和图表,可以帮助用户更好地理解每个步骤。可视化起来,也可以上传带字幕的视频~
添加警告和注意事项:在必要时添加警告和注意事项,以确保用户不会犯错误或造成问题。
确认准确性:最后,你需要用户帮助/操作手册中的每个步骤,以确保步骤正确,易于操作,并且能够帮助用户使用系统/工具。
最后再分享几点:
1、多借鉴学习成熟的系统/工具写的用户帮助/操作手册,汲取他们的优点 ~
我这里借鉴的操作文档有:
Worktile 帮助文档:https://help.worktile.com/spaces/sAoIbomH6f/pages/5ffe73544a0d539ad2c7aef9
Apifox 帮助文档:https://apifox.com/help/
PingCode 帮助文档:https://pingcode.com/spaces/si4PJHASUg/pages/5fc8642e515b3ac28f58b979
2、帮助文档常更新,对于用户经常问的问题可以整理一篇常见问题合集。
3、我认为好的用户帮助/操作手册,需要:
- 引导用户上手文档(了解系统、快速上手)
- 可视化结合图片、视频
- 目录、层次、标题清晰
- 内容准确,描述易懂
- 用户一看就会,可以帮助用户解决问题
编写用户帮助/操作手册指南相关推荐
- UOS桌面版103X忘记用户密码操作手册
103X系统更新后取消了单用户模式,推荐采用Livecd模式修改用户密码.具体操作步骤如下: 忘记密码后如何重置,输错密码如何解除锁定,系统修复,资料备份都可以使用UOS运维工具 1.下载UOS运维工 ...
- dll文件懒加载_dll编写与使用操作手册
一写dll需要建立至少三个文件: 1 .cpp文件用于写核心代码. 里面包括一个dll入口函数DllMain.形如: 包括需要导出的变量和函数,图中的是add.以及不需要导出的变量和函数. 2 .h文 ...
- 如何编写用户操作手册
1 引言 1.1 编写目的 说明编写这份操作手册的目的,指出预期的读者. 1.2 前景 说明: a.这份操作手册所描述的软件系统的名称: b.该软件项目的任务提出者.开发者.用户(或首批用户)及安装该 ...
- HTML的操作手册,Html的操作手册及编程
操作手册 1 引言 1.1 编写目的 说明编写这份操作手册的目的,指出预期的读者. Jquery操作手册Jquery简介? 1. 什么是jquery? 1. 是一个javaScript函数库. [转] ...
- 操作手册(GB8567——88)
操作手册(GB8567--88) 1引言 1.1编写目的 说明编写这份操作手册的目的,指出预期的读者. 1.2前景 说明: a. 这份操作手册所描述的软件系统的名称: b. 该软件项目的任务提出者 ...
- 软件生存周期文档系列 之 6.用户操作手册
6 用户操作手册 6.1 引言 6.1.1 编写目的 6.1.2 项目背景 6.1.3 参考资料(包括项目计划任务书.合同或批文:项目开发计划:需求规格说 ...
- 关于编写公司软件测试规范操作手册计划书
1.前言 本文档主要描写对该计划的前期阐述,说明其重要性与操作过程的前期计划.着重点描述未来 <本公司软件测试规范操作手册>的深度与可操作性等问题. 2.为什么要编写此规范手册 首先从公司 ...
- 六、软件用户操作手册-模板
六.软件用户操作手册 1.引言 1 1.1编写目的 1 1.2项目背景 2 1.3定义 2 1.4参考资料 2 2.软件概述 2 2.1目标 2 2.2功能 2 2.3性能 2 3.运行环境 2 3. ...
- 最好的程序界面就是用户无需去阅读操作手册就知道该如何使用的界面
最好的程序界面就是用户无需去阅读操作手册就知道该如何使用的界面. 原则 1.一致性 如果你可以在一个列表的项目上双击后能 够弹出对话框,那么应该在任何列表中双击都能弹出对话框.要有统一的字体写号.统 ...
最新文章
- Windows 系统下使用grep 命令
- 高级转录组分析和R数据可视化专题研讨会(2019.12)
- 【Sublime Text3】Package Control:Install Package不能使用解决方法
- valgrind安装使用
- c语言二分法查找次数,二分法查找
- 客户网页WIZnet无线解决方案 之 太阳能逆变器
- mysql-优化班学习-8-20170606-MySQL索引
- java 多线程 关键字_java多线程基础(synchronize关键字)
- DI、IOC基础学习笔记
- 计算机图形学完整笔记(四):消隐
- SQL 从入门到精通
- CSAPP第六章家庭作业参考答案
- 三维校园(三维虚拟校园)的使用体验
- rgb sw 线主板接口在哪_有颜值也有实力!利民TL-C12S幻彩RGB电脑散热风扇评测
- 技嘉ide模式怎么改,电脑BIOS中怎么设置硬盘为IDE模式
- Vision Transformer综述翻译
- SAP资产负债表实现方案探索 - 基于 VBA 自定义函数方法
- 2009最新山东省百强企业排名
- 【HDU】4942 Game on S♂play 线段树
- bzoj 3838: [Pa2013]Raper (线段树)