所有不给用户提供帮助文档的产品,都不是好产品。自然也无法得到用户的青睐。
很多产品方没有给用户提供一份细致的帮助文档,究其原因,需要耗费大量精力去完成文字工程的搭建除了语法和逻辑,好文档还要照顾读者的心理感受;
二则传统软件的客户对文档无感,它仅仅作为合同约定的交付物存在,客户压根就不会读这些文档,他们更依赖我们提供的现场培训和技术支持,让客户看文档自学太不符合甲方的身份了。
但现如今大部分软件产品都通过互联 向用户提供服务了,在线文档才是最高效的客户服务通道,我们熟知的那些开源软件都配有高质量的在线文档。好文档是优秀产品的标配,它不仅可以帮产品带来更多的用户,而且还可以提升用户的使用体验。
运营&开发作为产品帮助文档的撰写者,对文档的好坏需要有一个准确的评判标准。
好帮助文档的评判标准是什么?
一、明确帮助文档的受众对象
写产品帮助文档,如果是为了交差而写,脑袋很容易卡壳,思路无法拓展。在敲键盘之前,我们先要想清楚这份文档是写给谁看的,通过这份文档可以帮读者解决什么问题。
写作是我们输出影响力的一种能力,其最终目的是为了改变读者的信息、行为,否则就是言之无物的垃圾。等明确了目标读者和意义之后,我们的思路也就打开了。
二、简单的表述
编写技术文档的过程中会遇到哪些常见问题呢?通常我们习惯一上来就非常详尽地介绍这款产品有哪些特性,具体怎么安装、配置和使用等等…
其实大部分潜在用户都是初次接触此类产品,他对我们的产品还没有完整的认知,压根不知道这款产品到底能帮他解决什么问题,对他而言有什么价值,一上来就深入细节就很容易把潜在用户搞蒙。编写帮助文档不是简单地增加文档篇幅,尽量简洁易懂的文字,更容易被用户所吸收。
三、帮助文档内容之间的联系
帮助文档的开篇必须要通过介绍产品或方案的价值来跟用户建立连接,让他知道这款产品的工作是息息相关的,它可以帮助他优化工作。
接下来才是让用户了解这款产品是什么,以及怎么使用。这其实跟软件研发的流程类似,从用户需求开始,先分析梳理用户的痛点,再到产品需求,设计一款产品来解决用户的痛点。
四、合理的排版结构
当我们明确了文档的目标读者,也明确了可以为读者解决哪些问题,写作本身就有了指向和价值。在此基础上,我们就可以开始考虑文档应该包含哪些内容,目录章节该怎样安排设计才更符合用户的学习规律。
文档就是我们对外输出的一个产品,做产品就要学会换位思考,站在用户的视角考虑他们需要什么样的产品或方案,文档的章节目录设计要围绕用户需求,同时需要注意新老用户的引导,以及常见问题的设置。
五、故事思维让文档不再枯燥
我们对故事类信息的接收会更加高效一些。如果你干巴巴地罗列产品功能特性,就像传统的产品使用说明书一样,那用户在阅读这份文档时是无感的,他会觉得枯燥无味、困难重重,无法将产品跟他遇到的问题联系起来。此时,我们就需要采用故事思维来组织包装这些素材,结合用户的使用场景讲故事。
除了以上几点外准确的搜索、定时的用户建议收集同样重要,还需要记住的一点产品帮助文档优化工作是长期的,随着产品的迭代用户的反馈都需要做到及时的相应。
文末推荐2款日常写帮助文档好用的工具
帮助文档工具推荐

Baklib
文档管理工具需要满足内部知识存储的同时,还需保证内容分享的便捷性。而一款好的文档管理制作工具,是需要要让内部搭建员工用得简单,外部访问的客户看着舒服。Baklib文档管理工具有以下四大优势。
- 外部展示上:Baklib提供了多种对外的展示主题支持手机端的适配(手机和电脑上的观看效果一样优质),可以随意的切换变更颜色,支持页面页脚、独立域名的添加…
- 细节:提供了很多实用的插件包括全局搜索、用户反馈功能、文章导读、帮助站点的访问统计、站点导航…

Baklib
语雀
功能特色
- 插入格式丰富:除了图片、表格等,还支持视频、公式、附件、思维导图以及代码块,满足了运营和开发的种种需求。
- 知识分享:语雀有一个叫“发现”的功能,可以将自己整理的文档发在这个交流平台分享, 区搭建的比较完善适合那些有想法爱分享的朋友。
- 数据安全:阿里系产品数据安全有保障,支持多种格式的数据导入和导出使用起来很放心。

语雀
声明:本站部分文章及图片源自用户投稿,如本站任何资料有侵权请您尽早请联系jinwei@zod.com.cn进行处理,非常感谢!