首页 观点分析 软件产品如何写出好的产品帮助文档

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

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

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

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

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

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

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

明确帮助文档的受众对象

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

简单的表述

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

帮助文档内容之间的联系

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

合理的排版结构

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

故事思维让文档不再枯燥

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

帮助文档工具推荐

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

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

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

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

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

免责声明:文章内容不代表本站立场,本站不对其内容的真实性、完整性、准确性给予任何担保、暗示和承诺,仅供读者参考,文章版权归原作者所有。如本文内容影响到您的合法权益(内容、图片等),请及时联系本站,我们会及时删除处理。

作者: suifengmianlai

为您推荐

一文秒解erp和sap系统哪个好用

ERP和SAP系统是企业资源规划(ERP)软件应用的两大供应商,ERP专注于数据结构和资源管理,面向小型企业。

电商数据分析怎么做,这里讲得很清楚了

关于电商数据分析怎么做的问题,有人从电商数据整理、分析开始讲,有人则着重于分析方法的介绍,也有人侧重于分析报表的制作。

质量管理 | 工业4.0背景下的质量数据分析-工业数据中心方法论

作为工业4.0的重要组成部分,质量4.0概念比以往任何时候都更加重要。

经典:商业智能BI解读,值得收藏

关注新闻的朋友们可能注意到了,最近这段时间关于数据要素、数字经济、数字化转型的相关行动越来越多,一方面是各级政府的政策规划以及大规模的发展行动,另一方面是则是各行各业的企业开始探寻数字经济,通过数字化转型进行改革,充分发挥数据价值。

电商数据分析方案和BI强强联合,一站式做分析

搭建一个电商大数据分析平台需要哪些条件?总的来说需要一套满足电商数据分析需求的方案,一个能够提供强大数据计算分析功能和数据可视化图表的平台,比如电商数据分析方案和奥威BI软件这样的组合。

发表回复

您的电子邮箱地址不会被公开。 必填项已用*标注

返回顶部