如何写出好的产品帮助文档?

2021-06-03 5

所有不给用户提供帮助文档的产品,都不是好产品。自然也无法得到用户的青睐。
很多产品方没有给用户提供一份细致的帮助文档,究其原因,需要耗费大量精力去完成文字工程的搭建除了语法和逻辑,好文档还要照顾读者的心理感受;二则传统软件的客户对文档无感,它仅仅作为合同约定的交付物存在,客户压根就不会读这些文档,他们更依赖我们提供的现场培训和技术支持,让客户看文档自学太不符合甲方的身份了。
但现如今大部分软件产品都通过互联网向用户提供服务了,在线文档才是最高效的客户服务通道,我们熟知的那些开源软件都配有高质量的在线文档。好文档是优秀产品的标配,它不仅可以帮产品带来更多的用户,而且还可以提升用户的使用体验。
运营&开发作为产品帮助文档的撰写者,对文档的好坏需要有一个准确的评判标准

好帮助文档的评判标准是什么

明确帮助文档的受众对象

写产品帮助文档,如果是为了交差而写,脑袋很容易卡壳,思路无法拓展。在敲键盘之前,我们先要想清楚这份文档是写给谁看的,通过这份文档可以帮读者解决什么问题。写作是我们输出影响力的一种能力,其最终目的是为了改变读者的信息、行为,否则就是言之无物的垃圾。等明确了目标读者和意义之后,我们的思路也就打开了。

简单的表述

编写技术文档的过程中会遇到哪些常见问题呢?通常我们习惯一上来就非常详尽地介绍这款产品有哪些特性,具体怎么安装、配置和使用等等,其实大部分潜在用户都是初次接触此类产品,他对我们的产品还没有完整的认知,压根不知道这款产品到底能帮他解决什么问题,对他而言有什么价值,一上来就深入细节就很容易把潜在用户搞蒙。编写帮助文档不是简单的增加文档篇幅,尽量简洁易懂的文字,更容易被用户所吸收。

帮助文档内容之间的联系

帮助文档的开篇必须要通过介绍产品或方案的价值来跟用户建立连接,让他知道这款产品的工作是息息相关的,它可以帮助他优化工作。接下来才是让用户了解这款产品是什么,以及怎么使用。这其实跟软件研发的流程类似,从用户需求开始,先分析梳理用户的痛点,再到产品需求,设计一款产品来解决用户的痛点。

合理的排版结构

当我们明确了文档的目标读者,也明确了可以为读者解决哪些问题,写作本身就有了指向和价值。在此基础上,我们就可以开始考虑文档应该包含哪些内容,目录章节该怎样安排设计才更符合用户的学习规律。
文档就是我们对外输出的一个产品,做产品就要学会换位思考,站在用户的视角考虑他们需要什么样的产品或方案,用户在技术选型时也是先确认产品或方案对其是否有价值,等他认可了这个价值之后才会进一步了解产品或方案的功能特性和使用方法。
文档的章节目录设计要围绕用户需求:首先,我们要分析用户的类型,明确哪些类型的用户会先接触到这款产品;再者,说服了这批用户之后会带来哪些新类型的用户,这就是产品推广过程中接触用户的自然过程。

故事思维让文档不再枯燥

我们对故事类信息的接收会更加高效一些。如果你干巴巴地罗列产品功能特性,就像传统的产品使用说明书一样,那用户在阅读这份文档时是无感的,他会觉得枯燥无味、困难重重,无法将产品跟他遇到的问题联系起来。此时,我们就需要采用故事思维来组织包装这些素材,结合用户的使用场景讲故事。
除了以上几点外准确的搜索、定时的用户建议收集同样重要,还需要记住的一点产品帮助文档优化工作是长期的,随着产品的迭代用户的反馈都需要做到及时的相应。
文末推荐2款日常写帮助文档好用的工具

帮助文档工具推荐

Baklib是一款在线的文档编辑及内容分享工具,不仅为企业提供了好用的知识整理平台,还提供了优质的知识发布平台,通过Baklib制作的文档内容会自动转化成网站,通过设置的url链接就能进行访问,方便客户在线观看,帮助他们对产品的理解,为用户使用提供便利。
网址:
文档管理工具需要满足内部知识存储的同时,还需保证内容分享的便捷性。而一款好的文档管理制作工具,是需要要让内部搭建员工用的简单,外部访问的客户看着舒服。Baklib文档管理工具有以下四大优势。
  1. 操作上:Baklib在操作上无需构建文档框架(每个主题都有对应的展示框架 现在的话有15个主题都是针对帮助文档场景),打开浏览器就可以用,不懂编程技术会用Word就能轻松编辑文档,随时编辑、随时更新、随时发布,让客户点点鼠标就可轻松查看。
  2. 外部展示上:Baklib提供了多种对外的展示主题支持手机端的适配(手机和电脑上的观看效果一样优质),可以随意的切换变更颜色,支持页面页脚、独立域名的添加...
  3. 细节:提供了很多实用的插件包括全局搜索、用户反馈功能、文章导读、帮助站点的访问统计、站点导航...
  4. 编辑器:丰富的富文本+Markdown让编辑更加轻松(支持视频、图片、文件上传)

语雀

这是阿里巴巴开发的在线文档工具,孵化自蚂蚁金服,这是一款「专业的云端知识库」,已是 5万+ 阿里员工进行文档编写、知识沉淀的标配。内部协同功能完善,编辑器很强大功能上十分齐全,但相对的需要花费更多的时间去做了解和掌握。创作出来的内容会展现成一本书简洁便于阅读。
网址:https://www.yuque.com/dashboard
功能特色
团队协同:支持多人在线协同编辑,支持内容评审机制,适合中小型团队使用。
插入格式丰富:除了图片、表格等,还支持视频、公式、附件、思维导图以及代码块,满足了运营和开发的种种需求。
知识分享:语雀有一个叫“发现”的功能,可以将自己整理的文档发在这个交流平台分享,社区搭建的比较完善适合那些有想法爱分享的朋友。
数据安全:阿里系产品数据安全有保障,支持多种格式的数据导入和导出使用起来很放心。