转行Technical Writer的一点心得体会

对世界和自己的双重认知，决定了你在世界走哪条路。

                                                    -----------------笔者感悟

15年职场路，让我得出这个结论。

本人外语系毕业，喜欢语言（中文和英文），喜欢写作画画，喜欢笔头唠嗑，喜欢灌水。没什么特长，除了喜欢写文章，有独特的见解，曾经偶有野心，如今只愿岁月静好，多陪孩子家人。

职场大概分为三个阶段：

刚毕业在一家大型港资电信公司做技术翻译，工作稳定又轻松。

而后不安分，辗转去了服装行业（fashion retailer for menswear）做了几年的高管助理，砥砺自己的性格和发展。

随后生宝宝，开始重新起航，对自己有全新的认知，带着过往的阅历和沉淀，多了几分成熟和淡定。

2017年，我刚生完二宝，赋闲在家，带娃的同时，也整理自己前几年职场的经验，思考着下一步怎样走。 我一度认为，可能自己的职业生涯也就这样了，很难再找到合适的机会。

一个下午，突然接到猎头的电话，介绍一个Technical Writer的职位，还声称福利非常好，作为三方派驻到客户现场，享受两家公司的福利和假期。

当时的我，二宝才几个月，当时还没完全做好准备要重入职场。但与接到猎头推介得其它职位不同，比如总经理助理之类，我一概拒绝。因为在之前的服装行业摸爬滚打几年，感觉到已经厌倦那种传统行业的不稳定性和应接不暇的人事变化。 我决定不再走行政管理+翻译的路线。

说下当时毕业后的职业追求： 刚毕业后，一直在做着翻译相关的工作，曾经在一家大型港资电信公司做了四年技术翻译。可惜当时技术翻译在那个公司是相当边缘化的职位，虽然得心应手，但比较难有机会比较紧密地接触技术开发。后来出于小时候一直的“梦想”, 做一名具有企业家气质的商业女性，我想到了可以先从助理这个岗位入手，先跟着职业经理人或高管做事，学习他们的商业思维，接触企业的商业运作。

  于是投了一些外籍高管助理的岗位，既可以用到自己的英语专业特长，又可以学习商业。得益于自己的英语底子，面试总是很容易得到offer，当时一得到Offer,并且考虑到是大公司，就没有考虑到行业。于是，我进入了服装行业“助理”这个职业，在服装公司一干就是五年。

  不得不说，虽然最后还是跳出了服装和助理这个圈子，但在传统行业那几年，确实极大地开拓了我的眼界，跟在领导后面接触过不同的场合，形形色色的职场人，酸甜苦辣，不一而足，可以写一本书。这些经验对我的性格，为人处世也有极大的帮助，这也为我后来成为technical writer/communicator，去应付不同角色和性格的人，奠定了很好的沟通底子。一些能随时引爆一个人的脾气和让人抓狂的场面，我也能稳住自己，不慌不张，不喷人，不失态，最后稳住阵脚。

    成功面试Technical writer，主要归功于两点，首先英语底子过硬，能在面试中shine出来，2.曾经有过技术翻译的经验，虽然时间有点久远，也算加分项。3. 在服装行业做的工作中，不乏为公司写文案，写项目文档的经验，也有衔接各个部门推进项目落地的协调经验。 所以line manager破格给了我一个机会，让我非常珍惜。

刚开始入职，面对全新的工作，我是心虚的。技术文档工程师，是以写作为载体的工作，但本质上，这是一份技术工作。作为新人，面对一堆专业术语，犹如听天书。所幸公司的开发方式是敏捷开发，每天可以在早会上去听大家的工作汇报，这个时候可以把听到的不懂的东西记下来，利用Google这个强大的工具去查，还有就是用心积累。

首先，经过四年的经验，有时候我们经历的产品，可能是一眼望不到边的，哪怕是开发人员，也未必完全对系统完全了解其中的功能或玄关。由于一般都是分组开发，很多时候开发人员只对自己负责的那个模块比较熟悉。所以，如果自己一开始不懂，不要责怪自己，也不要怀疑自己的智商。

对于产品知识的习得，是日积月累的结果。作为文档工程师，我们只能从日常跟进的每个feature入手，了解当下feature的过程中去挖掘系统的其它使用方法。

当然入职开始，公司一般会安排senior的同事给我们介绍系统和产品总体介绍。如果没有足够的IT背景，况且senior同事一般都会从技术层面出发去介绍，他们的介绍如果难以与writer本身固有的认知联系起来，那些产品知识只能在脑海上空盘旋，很难落地化为自己用大白话也能和路人甲说清楚的东西。

刚入职那会，因为太多不懂，我一度怀疑自己。周围的人似乎也以说别人不懂的话，作为一种“高深”和“懂行”的表现，听不懂只是听者的知识储备问题。

作为writer，要让自己的知识储备跟得上你处在的context, 成为读懂context的人。

从一开始对自己跟进的系统无从下手，到后面基本能顺利安装和进行各种操作，我经历了以下几个阶段和一些技术学习的心得体会：

恍惚犹如听天书：

最开始的进入项目组。我进入的是媒体相关的内容管理系统开发项目组。 刚开始，对这个行业和整个系统所处的生态体系，上游下游体系，客户群体不太了解。

先跟着开发节奏去follow up每个sprint的文档任务。可以先帮忙做一些文档review开始慢慢开始看文档。 这个过程，可以记录看到的新词汇，做一些笔记。

IT圈的开发人员都热衷于给自己建立一个在线的笔记，比如OneNote, 有道云笔记，Google Docs等，随时随地积累新知识。

学习是IT圈的常态。不管是文档开发，还是开发人员，每接到一个新的需求，计划开发任务，都例行需要进行quick study，查阅已有的文档，看需求文档，设计文档等。如果是开发涉及到全新的技术，比如container，docker等，那必须开展全员学习。有必要时，还需要聘请外援专家，给内部人员进行一定的培训。

学习的方法很多。Mind Map巧利用。

对于未经过计算机科班学习出身的technical writer, 缺乏有体系的学习。 这时候，在排山倒海般的各种术语中，很有必要建立structured learning in an unstructured surroundings. Mind map是一个很好的办法，可以让我们把知识整理起来，梳理好，并不断挖掘自己不懂的知识。

曾经的我，没用过Mind map软件，刚开始用时也是比较简单，也比较抗拒。 但后来画几次mind map之后，确实这个工具能让自己的知识积累变得有结构起来。 我给自己专门建立了一个Tech Study的folder，定期学习，画mind map。

勤分享。越分享，越进步，这句话在IT圈也是非常行得通。

Sharing是IT工作一个不可或缺的环节，比如code sharing, tech sharing甚至一些testing sharing, 环境的搭建sharing... 程序员况且如此，technical writer也可以借鉴。一开始可以让line manager给自己找一个technical mentor。

我比较幸运，加入的研发团队line manager还是比较支持technical writer的，会配备一些资源让technical writer更好地学习产品知识。 比如，让technical writer定期去分享自己学习的知识，在这个分享session, line manager或其他技术经理，会帮忙补充或纠正一些理解，让我的理解更充分。

  第一年的technical writer生涯，我除了跟着开发节奏去学习产品功能，还定期与Line manager以及我的technical mentor去定期分享自己所学的知识。同时，我也恶补自己在计算机领域方面的基础知识，比如计算机如何处理0和1， 数据的类型，存储的历史，计算机发展历史，网络知识，域名解析等。

  所幸我所在的公司，思康也是一个注重techncal writer持续学习的公司。每周五都会有writer轮流去分享他们学习的知识，有趣的技术前沿知识等。 刚开始轮到我分享时候，我如临大敌。 一开始总是在绞尽脑汁想自己要分享什么知识，然后挖空心思地去搜索相应topic的内容，整理ppt，然后在分享之前还进行rehearsal，然后第二天战战兢兢地用英语去介绍自己准备的topic。计算机技术本来就是比较抽象，错综复杂，用英文去表达更加深了难度。  但毫无疑问，这种方式，会逼迫着我们去学习，去用自己的语言把高深的技术解释出来。 我在这个过程准备了computer storage history, message broker, virtualization and container， 每一次准备和分享，都让自己进步很大。 学习最快的途径，就是把所学分享给其它人。所谓“越分享，懂越多！”

当我们把学习养成了一种工作习惯，定期去学习新知识，有固定的学习平台，并养成了一边学习一边做笔记，不断丰富自己的技术知识库，这样我们就不再愁technical sharing时要分享什么topic了，很多时候都能信手拈来。在准备sharing时，这个准备过程也相对自如，而不是为了分享而分享的东拼西凑，可以从自己的知识库里调动相关知识，去梳理整个思路。

作为Technical Writer, 很多时候都是在自己不熟悉的领域，去学习新产品，接触之前可能完全没背景的行业。快速学习新产品和新行业，是必要的技能。同时面对新知识，只有掌握了学习之道，才不会迷失自己，保持游刃有余。

同时，学习也不再是古板的教科书式学习。现在的网络资源，提供了很多自我提升的平台。比如一些大学的online open courses, youtube上各种webminar和小视频，linkedin learning上的课程，udemy等的付费课程，不一而足。个人完全可以根据自己的碎片时间，在繁忙的工作之余，保持充电状态。

Google也提供了一些快捷学习办法. Google可以是很好的老师，遇到不懂的术语，可以同构搜索去挖掘有助于自己理解的咨询。

身边的developers也要好好利用下来，跟他们打好关系，不耻下问。比如linux的一些操作命令，我刚入行时几乎一窍不通。在撰写技术性比较强的installation guide时，会收到很多带着command的input。 接触得多了，积累了一些比较常用的命令用法。在跟developer了解Input的过程中，也会了解到一些command的用法。自己平时再上网查阅linux系统操作的一些用法，找一台机器上去试着运行几下，慢慢地就掌握了linux命令的一些实用办法。现在基本对着文档，我已经可以能操作一遍。看到命令，基本理解这个命令是做什么的，看到可疑的命令，也能提出自己的看法，让developer去确认input的正确性。 毫无疑问，在工作中，我们接触最多的开发人员和Product owners们，在和他们了解Input的过程，能极大促进自己的技术知识和产品知识，要特别珍惜和这群人打交道的时间！

作为文科生，面对浩如烟海的IT技术世界，可能感到无从下手。一开始往往从自己最擅长和习惯的地方入手，比如看到术语记录下来，弄清楚每一个术语的意思，把文档的术语库管理好。但这种做法的弊端是，只从文字表面去理解，缺乏真正理解术语之间的关联关系，很容易断章取义。 为了避免这种问题，在学习每个术语时，也需要了解他们的逻辑关系。我们必须懂得每一行代码是怎样串联起来，形成一个代码repo，代码repo又怎样被运行起来，在前端变成UI， 在后端如何运作。同时整个软件开发过程中，team与team之间的代码如何协作和相互重用，每天如何把代码build出来等。

  网上很多给beginner的编程课，比如学习python或Javascripts。 我认为软件行业的technical writers还是很有必要给自己配备一定编程知识。世界上一流的IT大牛公司招聘technical writer，比如Google，其中有一项要求，就是面试时让应聘者能读懂一段代码。Technical Writer只有深谙代码之道，才能算是知道软件开发最基本和底层的东西，才能有底气去往上挖掘更多产品的知识。 况且未来社会，极大可能是人工智能的社会，编程会成为未来一代的基本技能，不会编程如同文盲。作为Technical Writer，让自己与世界接轨，成为一个站在技术前段的酷酷的自己，何乐而不为呢。 退而言之，Technical Writer应该有这种追求前沿知识的心态，这几乎可以说是一个职业的“职业操守”。

基于这些考虑，我给自己报了基本的编程课。这些或免费，或付费的网上课程，老师在讲解的过程中，也会简要介绍一些软件开发的过程，以及计算机的一些基础知识。这对与巩固和加深之前的理解，帮助自己梳理自己的知识体系，非常有帮助。我也强烈推荐软件行业的technical writer，可以给自己设个小目标，比如三年内学会一点编程知识。

我身边曾经合作过一些技术牛的technical writer，在收到开发的input后，可以自己去看代码；或者有时自己就能通过代码，来提取一些input，从而大大提高了写作效率。　在写作过程中，对于涉及的一些ｃｏｄｅ相关的描述，也能更精准。

如今，我已经在这个岗位做了四年，经历了大大小小的ｒｅｌｅａｓｅｓ，也处理过各种客户的反馈。对于产品的理解，我已经能从前段介绍到后端，能以客户的身份操作界面，也能以ｓｅｒｖｉｃｅ维护人员的身份去安装一个庞大的系统。对于文档的驾驭，也到了得心应手的阶段。从一开始对整个项目组的文档如同云里雾里，到现在我几乎了如指掌，知道文档的每一个出处和改动过程。从刚近来那么怯生生和对技术一种天然的恐惧感，到现在几乎变成了一个“技术控”。　从刚加入听大家开会不知所云，到现在可以和大家一起开ｐｌａｎｎｉｎｇ　ｇａMe，听大家讨论技术细节和实现方式，也能提一点大家可能不知道的产品背景，被会议组织者邀请发表自己的见解，这是一个质的飞跃。

成功转行ｔｅｃｈｎｉｃａｌ　ｗｒｉｔｅｒ对自己的性格和生活也有极大的改变。首先，在大学时代的我，遇到电脑的任何问题，都会请教男同学；遇到前沿的科技，会胆怯，不敢去接触。　现在的我，对于科技，有了更多淡定。家里的电脑坏了，自己会对着说明书，或打开ｂａｉｄｕ找到解决的办法，自己去拆主机去修理。日常一些软件问题，自己也能通过ｇｏｏｇｌｅ去处理，而无需劳烦自己的家人。家里的电视机有什么新功能，我自己也饶有兴趣地去钻研他们的说明书，使用那些新功能，让自己的家居生活也多了一些高科技的色彩。孩子们都能享受到一个懂科技的妈妈带来的好处。比如他们上网课，我可以让帮他们投屏到电视上去互动，也可以找到很多国外的科技视频给他们观看，让他们也变得国际化。家里购置了什么新玩意儿，我都能对着说明书安装起来，有时还会对着别的产品的说明书评头品足。科技，真的没有之前想得那么遥远和望而生畏！

现在的自己，已经把科技学习融入到自己生活的方方面面。我已经在向着“技术”的大道上乐此不疲地奔跑着，并享受着科技和这种学习的思维带来的好处！！我深知，这是一次正确的转行。每天工作八个小时，我可以心无旁骛。每一次ｒｅｌｅａｓｅ，我都可专心致志地仔细阅读每一本文档，修改每一处ｃｏｍｍｅｎｔｓ。难道这就是所谓得“心流”？　一种不为名，不为利，能把自己的优点和性格优势发挥到极致的工作？或许是的，非常庆幸这几年的积累和摸爬滚打。