Foreword
之前分享过一篇不同阶段如何应对 Technical Writer 的职业顾虑或烦恼,从在校大学生、应届毕业生、有工作经验的 Technical Writer 三个方面谈了些个人建议。
后来,有些即将离开校园踏入社会的读者给我留言,咨询什么样的人适合做 Technical Writer,或者自己想转行做 Technical Writer 但又有些犹豫,不知道自己到底合不合适。
关于这一点,通常招聘信息中会有一些基本的说明,比如专业、学历、英语能力等等,这里将结合个人看法以及工作中对周围同事的观察从 9 个方面来谈谈什么样的人适合做 Technical Writer。
当然,关于这个问题见仁见智,欢迎大家留言交流或补充。
希望那些有疑惑的小伙伴们在看完本文后,可以对 Technical Writer 这个职位有更进一步的了解,同时思考一下它是否适合自己,以做出更好的抉择。
1. 个人性格
有意入行的小伙伴或许会有这个疑问:自己的性格是否适合做 Technical Writer 呢?是内向的更适合,还是外向的更是适合?
在 Google 里输入关键词 "technical writers introverted" 即可得到很多搜索结果,看来有很多人关心这一问题。有疑惑的小伙伴可以先去看一下那些讨论、回答或者博客文章。
我在工作中所接触的同行们有的偏内向,有的偏外向,两种性格均有各自的优势。外向者通常更擅长与 SME (Subject Matter Experts) 沟通,内向者通常更擅长较长时间的独自写作。
有一些心理学者倾向于认为 Writer 一般是内向的性格。个人比较认同的一种观点是:
-
在实际工作中,绝对的内向是不合适的,至少要做到专业。
因为日常工作中会涉及很多沟通工作,如果你只想待在个人独立工作的舒适区,很可能会严重影响你的工作质量。沟通不到位,往往会导致内容呈现不准确,甚至是错误。所以,在工作中需要沟通的地方,必须主动地去沟通。
-
在个人社交中,可以根据自己的喜好来。内向一点就宅着,外向一点就出去跟朋友 social。
我认识的大多数 Technical Writer 一般都能很有耐心地去处理文档,同时遇到问题也会主动去与技术同学沟通,同事之间相处得轻松愉快。工作之外的个人生活中,他们也会把自己的生活过得丰富多彩。
TechWhirl 上有一篇文章详细讲述了内向、外向性格的人在技术写作中的区别、不同的工作风格,以及各自如何做好技术写作:Discovering Your Natural Writing Process: Extraversion vs. Introversion in Technical Writing
无论你是偏外向,还是偏内向,还是内向加外向,只要方法得当,都可以做好。但必须问自己一个问题:是否既能安安静静地坐下来写文档,又能积极耐心地与他人沟通?如果回答是肯定的,那不妨试试。
2. 对细节的敏感度
常言道,细节决定成败。细节对于技术写作来讲尤为重要。可以说,对细节敏感是对 Technical Writer 的一个最基本的要求。
你可以回想一下过往的学习、生活或工作,看看自己是不是一个对细节敏感的人。
如果你是一个大大咧咧的人,个人不建议尝试 Technical Writer 这个岗,不然你自己会很痛苦,跟你共事的人也会很痛苦。久而久之,你自己很有挫败感,你的同事痛苦不堪避之不及,你的上司自然也无法交付给你更重要的任务。
例如,你处理完了一篇文档,请另外的 Technical Writer 做语言的 review,可能会有很多问题,常见的如格式错误、Typo、用词不规范,考虑不周导致的该写的没写、该改的没改、不该删的删掉了等等。
虽然现在可以采用一些工具来自动检查格式、单词拼写等,但对细节敏感依然特别重要。
3. 英语能力
要做处理英文文档的 Technical Writer,扎实的英语基本功是另一个基础的门槛。满足不了,就会被拒之门外。
技术写作,顾名思义,英语写作能力要很好。此外,工作中很可能会涉及与外籍同事的视频或电话会议,因此,听、说能力也必须过关。读,自然也是日常工作中几乎每天都会涉及的。所以,你可以自我评估下,自己的听说读写能力如何。
当然,你或许会说,在你以往的工作经历中,这项工作几乎不会涉及听、说,主要是写作,沟通也基本通过邮件。确实也存在这种情况。
但是,现在行业的发展对 Technical Writer 提出了更高的要求,工作任务也更加多样化,必须用更多的技能武装自己才能有更多的选择,才能走得更远。
4. 技术写作能力
如果你打算入技术传播或技术写作这一行,需要具备基本的行业与专业知识。
网络上有很多资源可以帮助你学习或了解,这个了解的过程也是对自己负责。在选择它作为自己的工作之前,至少要知道它是干啥的。
或许你没有机会去获得相关工作经验,以前可能不好办,但现在完全可以通过参加开源项目来积累相关经验。而且,你为开源项目贡献的所有文档修改都可以呈现在你的 GitHub 页面。
想快速了解这一行业的小伙伴可以翻翻我之前的分享,例如:
5. 沟通能力
从文档需求的确定,到技术文档的发布,期间需要与多方沟通。很多时候,沟通也是一门学问。Technical Writer 至少要做到以下两点:
第一点,不要刻意回避沟通。
有些内向的 Technical Writer 可能会本能地排斥与他人沟通,某段话虽然不确定自己理解得对不对,但觉得去找研发人员确定太麻烦了,干脆就算了,意思应该差不多吧。
这种情况发展下去,会导致产品的文档质量下降,易用性降低。如果传递的信息不准确甚至错误,那么对于用户来说就是无用的,甚至会带来一些严重的后果。
第二点,要尽量做到有效沟通。
例如,与研发人员沟通时,如何获得你想要的信息。程序员的思维与 Technical Writer 的思维往往是有区别的。你问他们一个问题,他们告诉你一句话,你可能觉得对方已经回答你了,虽然自己并没有完全理解,但不好意思再多问,就按他们说的来翻译吧。然而,很多时候你直译过去放到英文文档里,很可能就是错的。
此时,这种沟通就是无效的。那该怎么办呢?首先,将产品理解到位。其次,了解程序员的说法方式,多一点思考。再次,将自己的理解告诉对方进行确认。
以我现在在 PingCAP 的工作为例,处理文档时常常需要与以下人员沟通:
- 研发人员
- 售前售后支持人员
- 产品经理
- 其他的 Technical Writer
6. 团队协作能力
技术文档写作不是一个人孤军奋战的事情,会经常涉及团队协作,既包括与自己所在团队同事的协作,也包括与其他团队同事的协作。
例如,在产品要发布一个大版本前,通常会涉及较多的文档更新,而且有明确的 deadline。此时,Technical Writer 可能需要 review 技术同学写的大量中文文档,翻译为英文,并 review 其他 Technical Writer 翻译的英文文档。
在团队内部,也偶尔会有一些工作量大且紧急的任务,通常需要团队的多个小伙伴一起协作,合力完成。
在团队协作的过程中,需要尽量做到:及时有效沟通,互相建立信任,遇事冷静处理,学会换位思考。这样更容易在工作中保持一种愉快的心情,体会到工作带给你的快乐。
7. 拥抱技术
技术发展迅速,我们要跟上时代的变化,就要积极地拥抱技术。这里的拥抱技术至少可以理解为以下三点:
关注热门行业的发展变化,了解行业趋势。
关注自己公司产品所在领域的行业发展,熟悉和理解公司产品。
关注并掌握一些技术传播领域的技术应用,以及采用各种技术工具来简化日常工作,提高工作效率。
8. 快速学习能力
很多岗位都要求候选人具备快速学习能力,Technical Writer 也不例外。
那么,需要快速学习些什么呢?以在 PingCAP 做数据库 TiDB 的文档为例:
- 快速学习基本的数据库知识,熟悉公司的产品,理解产品的实现。
- 快速了解、掌握公司的技术文档写作流程。
- 快速学习、熟练使用技术写作工具或平台,以及一些提高写作质量和规范性的实用小工具。
无论是否有技术背景,如果你具有快速学习能力,又不排斥学习一些比较技术的东西(如数据库),以上几点都是可以做到的。其中的写作工具掌握起来特快简单,可参考:
- Markdown:写技术文档、个人博客和读书笔记都很好用的轻量级标记语言
- 技术写作工具 | GitHub + Markdown 的新轻型技术写作模式速览
- 技术文档方案 | GitHub + Markdown 的深度实践解析
9. 坚持成长
具备了快速学习能力之后,还要坚持成长,把这种学习能力一直延续下去,不断提升自己。这样,才能在快速发展的今天保持竞争力。
在熟练掌握了日常工作之后,可以主动发现和思考一些问题,看是否可以找到办法提高日常工作效率和质量,是否可以做得更好。
此外,还可以从以下几点入手:
- 学习技术传播领域内除了技术写作之外的一些技能
- 学习业界技术文档的一些新的实践
- 学习产品相关的技术知识
- 结合所在团队的整体需求来提高一些相关技能
Afterword
人各有长处,不同的人擅长的事情也不同。
如果你发现自己很适合做 Technical Writer,不妨抓住机会试一试;如果你发现 Technical Writer 这项工作不适合自己,会让自己很痛苦,不妨果断地寻找更适合自己的工作。
认为自己很适合做 Technical Writer,同时又在留意工作机会的小伙伴可以长按下方二维码,查看 PingCAP 现在开放的 Content Strategist 岗位:
如果你是一个早期的细心读者,或许会发现 2018 年贴的岗位名称为 Technical Writer,现已更名为 Content Strategist。为什么呢?有机会再跟大家聊聊~
-END-
你可能想读:
技术文档诞生记 | 完整的技术写作流程是怎样的?
Technical Writer 可提供的交付物有哪些?
GitHub + Markdown 的新轻型技术写作模式速览
GitHub + Markdown 的技术文档方案深度解析
Technical Writer 日常工作中好用的小工具
技术传播人士应该知道的色彩搭配常识
如何使用颜色来提高技术文档的可读性?
Technical Writer 如何 Review 技术文档?| 重细节+全局观
技术翻译需要有 Technical Writer 的 sense
深度解析关于技术翻译的六个认知误区
如何让你的内容输出更加专业更有设计感?
书单 | 有哪些技术传播从业者必知必看的书籍?
有哪些适合技术传播从业者关注的优质博客?(一)
有哪些适合技术传播从业者关注的优质博客?(二)
行业动态 | 国内有哪些高校开设了技术传播或技术写作课程?
IEEE ProComm 2019 国际传播大会上,中国代表团有哪些精彩分享?
优质免费资源推荐 | 9 期技术写作短视频教程带你从入门到进阶
经验分享 | 来自 11 位 Technical Writer 前辈的职业发展建议(上篇)
经验分享 | 来自 11 位 Technical Writer 前辈的职业发展建议(下篇)
Technical Writer 想参与开源项目为文档做贡献,需提前掌握哪些知识?
Technical Writer 如何参与开源项目的文档,以不断提升专业技能?
技术传播沙龙精彩分享 | 高校老师与行业大牛谈“互联网技术写作”
经验分享 | 对用户文档进行伤筋动骨式的重构是怎样一种体验?
英语技术文档的标题到底该大写还是小写?
不同阶段如何应对 Technical Writer 的职业顾虑或烦恼?
如何使用正则表达式批量添加和删除字符?
英语技术文档中如何正确使用时态?
英语技术文档中如何正确使用人称?
英语技术文档中如何正确使用无序列表和有序列表?
Markdown:写技术文档、个人博客和读书笔记都很好用的轻量级标记语言
如何为 Markdown 文件自动生成目录?
技术写作实例解析 | 简洁即是美
两分钟趣味解读 Technical Writer
若脱离理解,直译得再正确又有何意?
优质译文不应止于正确,还要 Well-Organized
Technical Writer 需要 Technical 到会写代码吗?
如何利用 GitHub Pages 和 Hugo 轻松搭建个人博客?
写在入职技术型创业公司 PingCAP 一个月之后
揭秘 Technical Writer 的工作环境 | 加入 PingCAP 五个月的员工体验记