什么样的人适合做 Technical Writer?

😋温馨提醒:文末附工作机会。

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. 拥抱技术

技术发展迅速,我们要跟上时代的变化,就要积极地拥抱技术。这里的拥抱技术至少可以理解为以下三点:

  1. 关注热门行业的发展变化,了解行业趋势。

  2. 关注自己公司产品所在领域的行业发展,熟悉和理解公司产品。

  3. 关注并掌握一些技术传播领域的技术应用,以及采用各种技术工具来简化日常工作,提高工作效率。

8. 快速学习能力

很多岗位都要求候选人具备快速学习能力,Technical Writer 也不例外。

那么,需要快速学习些什么呢?以在 PingCAP 做数据库 TiDB 的文档为例:

  1. 快速学习基本的数据库知识,熟悉公司的产品,理解产品的实现。
  2. 快速了解、掌握公司的技术文档写作流程。
  3. 快速学习、熟练使用技术写作工具或平台,以及一些提高写作质量和规范性的实用小工具。

无论是否有技术背景,如果你具有快速学习能力,又不排斥学习一些比较技术的东西(如数据库),以上几点都是可以做到的。其中的写作工具掌握起来特快简单,可参考:

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 五个月的员工体验记

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 205,386评论 6 479
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,939评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,851评论 0 341
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,953评论 1 278
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,971评论 5 369
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,784评论 1 283
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,126评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,765评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,148评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,744评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,858评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,479评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,080评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,053评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,278评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,245评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,590评论 2 343

推荐阅读更多精彩内容