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

Posted 浅川e

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了软件产品如何写出好的产品帮助文档相关的知识,希望对你有一定的参考价值。

软件产品因为其特点,常常需要为用户提供帮助文档,有好的帮助文档的产品常常会受到用户的青睐。

但是有很多企业不能为用户提供一份细致的帮助文档,因为他们没有用好的方法或工具,需要耗费大量精力去完成文字工程的搭建,也不会使用语法和逻辑。

还有一种情况是,很多传统软件的客户,没有使用文档的习惯,很多时候,帮助文档仅仅是作为合同约定的交付物存在,许多客户不会去使用这些文档,更多依赖现场的培训和技术支持。

但现如今大部分软件产品都通过互联网向用户提供服务了,在线文档才是最高效的客户服务通道,我们熟知的那些开源软件都配有高质量的在线文档。好文档是优秀产品的标配,它不仅可以帮产品带来更多的用户,而且还可以提升用户的使用体验。

那么如何才能制作好的帮助文档呢?

明确帮助文档的受众对象

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

简单的表述

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

帮助文档内容之间的联系

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

合理的排版结构

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

故事思维让文档不再枯燥

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

帮助文档工具推荐

Baklib是一款在线的文档编辑及内容分享工具,不仅为企业提供了好用的知识整理平台,还提供了优质的知识发布平台,通过Baklib制作的文档内容会自动转化成网站,通过设置的url链接就能进行访问,方便客户在线观看,帮助他们对产品的理解,为用户使用提供便利。网址:文档管理工具需要满足内部知识存储的同时,还需保证内容分享的便捷性。而一款好的文档管理制作工具,是需要要让内部搭建员工用的简单,外部访问的客户看着舒服。Baklib文档管理工具有以下四大优势。

  1. 操作上:Baklib在操作上无需构建文档框架(每个主题都有对应的展示框架 现在的话有15个主题都是针对帮助文档场景),打开浏览器就可以用,不懂编程技术会用Word就能轻松编辑文档,随时编辑、随时更新、随时发布,让客户点点鼠标就可轻松查看。
  2. 外部展示上:Baklib提供了多种对外的展示主题支持手机端的适配(手机和电脑上的观看效果一样优质),可以随意的切换变更颜色,支持页面页脚、独立域名的添加...
  3. 细节:提供了很多实用的插件包括全局搜索、用户反馈功能、文章导读、帮助站点的访问统计、站点导航...
  4. 编辑器:丰富的富文本+Markdown让编辑更加轻松(支持视频、图片、文件上传)

最近Baklib将举办一场线上企业知识管理培训讲座,针对软件产品如何通过帮助中心来提升使用体验,直播时间为8月26日周四晚7点半,了解详情或参与报名可扫描下方二维码。

也可以到官网添加客服进行报名咨询:https://www.baklib.com?utm_campaign=1&utm_content=fbc22f8f-4de9-42d2-8f1a-c3bba4de4389&utm_term=dcec69ed-c36e-4a4f-936e-4eda2bfe99db

以上是关于软件产品如何写出好的产品帮助文档的主要内容,如果未能解决你的问题,请参考以下文章

如何写出一篇好的API文档

产品好的产品需求文档(PRD)怎么写?

最全解决方案!秒杀帮助文档制作的5大关键问题

如何给VS2015安装MSDN本地帮助文档

微职位产品改版学员帮助文档(4月19日)

架构设计文档