美文网首页技术传播那些事儿
技术文档如何体现对企业的价值?

技术文档如何体现对企业的价值?

作者: Lilian_Lee | 来源:发表于2020-08-02 18:21 被阅读0次

话说技术传播圈儿里有一位与我同名的同行,不过她的英文名是 Emma。这里跟大家分享她的一篇新近好文,有助于深刻理解技术文档对企业的价值。

作者:Emma 李琳;原文出处;已授权转载。

--- 👇 以下是正文 ---

最近有个刚入行不久的技术文档工程师问我:如何说清楚技术文档对企业的价值?

这个问题的潜台词可能是:

  • 我公司领导不重视文档,认为可有可无;
  • 我感觉我的工作没有其他岗位重要;
  • 管理层认为写文档是开发人员的事;
  • 技术文档工程师就跟文员差不多,最多是个好编辑

当然还有一句是:你写了那么多篇文,我就想要一句话概括出来,到底为什么要写文档?

技术文档的价值是分阶段递增的。

下图的阶梯展现了文档价值的递增:从“不得不”的合规阶段,发展到提升产品和企业竞争力的战略阶段。

*来自华为资料部周剑毫的行业会议分享

这个模型最亮眼的可能就是“降成本”,因为跟企业利润有关。除此之外,产品技术文档是否也能成为盈利点?是否还有其他作用?

作为顾问跟很多企业打交道,听到过各种与产品文档有关的问题。这里介绍几个案例,看看最后他们是怎么应对这些问题的。

Q1. 技术文档能给企业带来收入吗?

产品文档是法规要求吗?是的。欧盟、英国、北美或国内,对产品文档有不同的法规要求。例如在欧盟,汽车的使用手册和维修文档,是上市准入的必备条件。在我国,《汽车维修技术信息公开实施管理办法》规定,对于取得 CCC 认证的乘用车和客车,要在车型上市之日起 6 个月内公开维修技术信息。

其他行业有各自的法规要求。产品文档不完善,可能导致严重的法律问题,如果引起人身伤害,面临巨额赔偿,这样的案例屡见不鲜。

产品文档影响服务成本吗?销售规模达到一定水平的时候,服务成本就凸显出来,如何更低成本的提供服务,是成长中的企业迟早会遇到的问题。

服务的组织搭建通常会形成一个阶梯。

第一阶是呼叫中心,客户打电话可以解决一些问题;

第二阶是一线服务工程师,上门服务解决问题。

再升级就是二线或研发,一些更有经验和产品能力的工程师,出马解决问题。

这个阶梯中,成本是逐级递增的。最好第一阶能搞定,这样成本最低。

这里面跟技术文档有什么关系呢?华为有句很有名的口号,叫七远八按,其中的“八按”,是指“按技术文档安装、配置、升级、解决问题.......”。后来提出“三免九自”,有九类服务项目,是用户在技术文档的指导下自服务完成的。这个案例说明,优质的产品文档,对降低服务成本,提高产品的全生命周期成本竞争力,至关重要。

某次我也问过德国行业协会的主席弗瑞兹博士,为什么德国的企业这么重视文档?他很明确的对我说,这是伴随着德国制造走向全球,产生的必然结果,并不是什么文化或思想所致,减成本、增利润才是关键。

产品文档影响市场销售吗?虽然产品文档通常意义上是售后文档,但现在,越来越多的招标活动需要提供全套的产品维护文档。

最近我与一家重工企业交流,他们在海外市场就遇到这样的问题:客户在招标阶段要求提供全套的维修文档,而产品是定制的,按照正常交付流程,只能售后阶段提供,导致投标失利。

为什么招标要看维修文档?产品即服务,或者说全生命周期成本,采购的时候考虑的不仅仅是功能和价格,而是设备的可维护性、可用时间、可靠性这些指标。维修文档、备件清单,是衡量全生命周期成本的证据。

产品文档能单独标价吗?多年前的中兴通讯文档开发部与培训部在同一个大部门下。培训课程卖的很贵,而产品手册并不能卖钱,偶尔出现在报价里,也就是个物料费用,跟合同总额比起来约等于无。

既然不能赚钱,那就给赚钱的部门干点活,争取分一杯羹。于是某阶段,文档开发部也承担了教材开发的职责,正好应用了 DITA 重用机制,把技术文档的内容模块快速组装到教材框架里,一天就可以发布一本新教材,速度比以前快了几倍,一时间皆大欢喜。

第一次见到大额的文档标价,是某个海外网络搬迁项目,产品文档报价 300 万,看看都觉得兴奋啊!这只是个例,但也说明产品文档的确值钱。

Q2. 技术文档工程师重要吗?

好吧,企业迟早会认识到技术文档的价值,那么技术文档工程师呢?

企业要先感知文档需求,再配置对应的资源。这是有时间差的。

很遗憾,这个时间差可能很长。多年前中兴有个国际项目不断遭到文档交付的投诉,面临合同中止的风险,于是 CEO 一声令下,负责研发的副总裁亲自督办,把整个研发部门闭关起来写文档——当时管理层也并没有认可专业文档工程师的作用。

全研发写文档没有解决问题。最后从文档部派遣了一位非常牛的文档架构师,才逐渐改善了答非所问、文不对题的尴尬局面。

我现在做的项目都是一些有志于开拓海外市场的大公司。美嘉林公司在制造企业的服务生命周期管理上,有非常多的实施项目经验,遍布各个行业。从这么多的大公司现状来看,技术文档工程师专业化、技术文档价值最大化,还很任重道远。

有不少企业,已经深切感受到了海外市场的压力,不管是品牌竞争、投标要求还是服务交付,技术文档已成短板。但不是每个企业都会快速建立技术文档部门。

有些只有小规模的文档部门,或者在某个部门内有部分专职的文档工程师。

有些几乎没有专职的文档工程师,只有文员、编辑类的岗位,负责文字审校和版本和存储等。

所以技术文档工程师是否重要?答案是,非常重要。尽管现状不尽如人意,但用高效准确的技术文档,包括各种格式的技术信息,去解决海外市场的各种问题,让中国制造更好、更长久的走向世界,是每一个技术传播人的愿景。

做好准备吧,同行们!

-END-

猜你想读

征稿启事 | 技术传播圈故事征集
什么样的人适合做 Technical Writer?
英语专业的同学可以做技术文档写作吗?
技术文档诞生记 | 完整的技术写作流程是怎样的?
Technical Writer 可提供的交付物有哪些?
免费学习资源推荐 | Google 面向工程师的技术写作课程
Write the Docs:连接技术文档人的全球社区,附海量学习资源
GitHub + Markdown 的新轻型技术写作模式速览
GitHub + Markdown 的技术文档方案深度解析
Technical Writer 日常工作中好用的小工具
技术传播人士应该知道的色彩搭配常识
如何使用颜色来提高技术文档的可读性?
Technical Writer 如何 Review 技术文档?| 重细节+全局观
技术翻译需要有 Technical Writer 的 sense
深度解析关于技术翻译的六个认知误区
如何让你的内容输出更加专业更有设计感?
书单 | 有哪些技术传播从业者必知必看的书籍?
有哪些适合技术传播从业者关注的优质博客?(一)
有哪些适合技术传播从业者关注的优质博客?(二)
行业动态 | 国内有哪些高校开设了技术传播或技术写作课程?
IEEE ProComm 2019 国际传播大会上,中国代表团有哪些精彩分享?
行业动态 | 2019 中国技术传播论坛上,大家都在谈论什么?
优质免费资源推荐 | 9 期技术写作短视频教程带你从入门到进阶
经验分享 | 来自 11 位 Technical Writer 前辈的职业发展建议(上篇)
经验分享 | 来自 11 位 Technical Writer 前辈的职业发展建议(下篇)
Technical Writer 想参与开源项目为文档做贡献,需提前掌握哪些知识?
Technical Writer 如何参与开源项目的文档,以不断提升专业技能?
技术传播沙龙精彩分享 | 高校老师与行业大牛谈“互联网技术写作”
经验分享 | 对用户文档进行伤筋动骨式的重构是怎样一种体验?
英语技术文档的标题到底该大写还是小写?
不同阶段如何应对 Technical Writer 的职业顾虑或烦恼?
如何使用正则表达式批量添加和删除字符?
如何使用正则表达式批量删除多个 Markdown 文件的指定行?
英语技术文档中如何正确使用时态?
英语技术文档中如何正确使用人称?
英语技术文档中如何正确使用无序列表和有序列表?
Markdown:写技术文档、个人博客和读书笔记都很好用的轻量级标记语言
如何为 Markdown 文件自动生成目录?
技术写作实例解析 | 简洁即是美
两分钟趣味解读 Technical Writer
若脱离理解,直译得再正确又有何意?
技术文档翻译实例解析:始于翻译,经于沟通,终于易用
优质译文不应止于正确,还要 Well-Organized
Technical Writer 处理技术文档时,如何避免内容理解问题?
Technical Writer 需要 Technical 到会写代码吗?
如何利用 GitHub Pages 和 Hugo 轻松搭建个人博客?
写在入职技术型创业公司 PingCAP 一个月之后
揭秘 Technical Writer 的工作环境 | 加入 PingCAP 五个月的员工体验记

相关文章

  • 技术文档如何体现对企业的价值?

    话说技术传播圈儿里有一位与我同名的同行,不过她的英文名是 Emma。这里跟大家分享她的一篇新近好文,有助于深刻理解...

  • 企业价值评估(3)

    昨天的正文中,我们讲述了对企业价值评估的流量模型。如何通过企业的实体现金流量、如何通过股权现金流量来评价一个企业的...

  • 老师说:“考生中专,你们也算小知识分子”

    个人价值如何体现? 上班,企业支付你工资,也是一种劳动价值的体现。 社会快速发展,有分解有重组,很多传统意义的东西...

  • 拿到一个测试需求时,如何入手写测试用例

    问:拿到技术文档该如何下手,如何建立测试用例树。 通读文档,明确产品的核心点(核心需求是什?和竞品比优势体现在哪?...

  • 《超越感觉》第7章 什么是论证?

    1. 如何理解价值观? 2. 在一个企业中如何体现价值观? 3. 尊重,信任,激情,卓越四个价值观你是如何理解的?...

  • 新媒体运营学习笔记1||新媒体运营为什么存在

    新媒体运营为什么存在?要从企业如何创造价值,运营在企业创造价值环节中的作用等方面说起。 (1)企业如何创造价值 对...

  • 路易斯·康:在建筑的王国中

    现代建筑对功能的过分强调和技术理性,建筑如何体现其公共或社会价值。一位现实取向的实践理性的社会工作者如何演变...

  • 自我价值

    如何体现自己的价值,让自己更值钱,让企业能重用,让自己不断取得成就,实现自我价值的最大化…… 我认为...

  • 价值,如何体现?

    这是我每天写一篇原创文章的第1207天 价值,如何体现? 能对别人有帮助,能满足别人的需求,就能够体现价值。 我们...

  • 体验设计的价值

    问:如何体现用户体验设计者的价值?答:通过你设计的流程,为企业节省了可观的成本,这个节省的额度就是你的价值。如何直...

网友评论

    本文标题:技术文档如何体现对企业的价值?

    本文链接:https://www.haomeiwen.com/subject/gvtmrktx.html