转行Technical Writer的一点心得体会-飞
发布时间: 2023-07-06

转行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, 每一次准备和分享,都让自己进步很大。 学习最快的途径,就是把所学分享给其它人。所谓“越分享,懂越多!”

当我们把学习养成了一种工作习惯,定期去学习新知识,有固定的学习平台,并养

微信