轉(zhuǎn)行Technical Writer的一點心得體會

對世界和自己的雙重認知，決定了你在世界走哪條路劳吠。

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? -----------------筆者感悟

15年職場路贩幻，讓我得出這個結(jié)論。

本人外語系畢業(yè)，喜歡語言（中文和英文）老客，喜歡寫作畫畫拭荤，喜歡筆頭嘮嗑茵臭，喜歡灌水。沒什么特長舅世，除了喜歡寫文章旦委，有獨特的見解，曾經(jīng)偶有野心雏亚，如今只愿歲月靜好缨硝，多陪孩子家人。

職場大概分為三個階段：

剛畢業(yè)在一家大型港資電信公司做技術(shù)翻譯罢低，工作穩(wěn)定又輕松查辩。

而后不安分，輾轉(zhuǎn)去了服裝行業(yè)（fashion retailer for menswear）做了幾年的高管助理网持，砥礪自己的性格和發(fā)展宜岛。

隨后生寶寶，開始重新起航功舀，對自己有全新的認知萍倡，帶著過往的閱歷和沉淀，多了幾分成熟和淡定辟汰。

2017年列敲，我剛生完二寶，賦閑在家帖汞，帶娃的同時戴而，也整理自己前幾年職場的經(jīng)驗，思考著下一步怎樣走翩蘸。 我一度認為所意，可能自己的職業(yè)生涯也就這樣了，很難再找到合適的機會。

一個下午扁眯，突然接到獵頭的電話壮莹，介紹一個Technical Writer的職位，還聲稱福利非常好姻檀，作為三方派駐到客戶現(xiàn)場命满，享受兩家公司的福利和假期。

當時的我绣版，二寶才幾個月胶台，當時還沒完全做好準備要重入職場。但與接到獵頭推介得其它職位不同杂抽，比如總經(jīng)理助理之類诈唬，我一概拒絕。因為在之前的服裝行業(yè)摸爬滾打幾年缩麸，感覺到已經(jīng)厭倦那種傳統(tǒng)行業(yè)的不穩(wěn)定性和應(yīng)接不暇的人事變化铸磅。 我決定不再走行政管理+翻譯的路線。

說下當時畢業(yè)后的職業(yè)追求： 剛畢業(yè)后杭朱，一直在做著翻譯相關(guān)的工作阅仔，曾經(jīng)在一家大型港資電信公司做了四年技術(shù)翻譯』⌒担可惜當時技術(shù)翻譯在那個公司是相當邊緣化的職位八酒，雖然得心應(yīng)手，但比較難有機會比較緊密地接觸技術(shù)開發(fā)刃唐。后來出于小時候一直的“夢想”, 做一名具有企業(yè)家氣質(zhì)的商業(yè)女性羞迷，我想到了可以先從助理這個崗位入手，先跟著職業(yè)經(jīng)理人或高管做事画饥，學習他們的商業(yè)思維衔瓮，接觸企業(yè)的商業(yè)運作。

? 于是投了一些外籍高管助理的崗位荒澡，既可以用到自己的英語專業(yè)特長报辱，又可以學習商業(yè)。得益于自己的英語底子单山，面試總是很容易得到offer，當時一得到Offer,并且考慮到是大公司幅疼，就沒有考慮到行業(yè)米奸。于是，我進入了服裝行業(yè)“助理”這個職業(yè)爽篷，在服裝公司一干就是五年悴晰。

? 不得不說，雖然最后還是跳出了服裝和助理這個圈子，但在傳統(tǒng)行業(yè)那幾年铡溪，確實極大地開拓了我的眼界漂辐，跟在領(lǐng)導后面接觸過不同的場合，形形色色的職場人棕硫，酸甜苦辣髓涯，不一而足，可以寫一本書哈扮。這些經(jīng)驗對我的性格纬纪，為人處世也有極大的幫助，這也為我后來成為technical writer/communicator滑肉，去應(yīng)付不同角色和性格的人包各，奠定了很好的溝通底子。一些能隨時引爆一個人的脾氣和讓人抓狂的場面靶庙，我也能穩(wěn)住自己问畅，不慌不張，不噴人六荒，不失態(tài)护姆，最后穩(wěn)住陣腳。

? ? 成功面試Technical writer恬吕，主要歸功于兩點签则，首先英語底子過硬，能在面試中shine出來铐料，2.曾經(jīng)有過技術(shù)翻譯的經(jīng)驗渐裂，雖然時間有點久遠，也算加分項钠惩。3. 在服裝行業(yè)做的工作中柒凉，不乏為公司寫文案，寫項目文檔的經(jīng)驗篓跛，也有銜接各個部門推進項目落地的協(xié)調(diào)經(jīng)驗膝捞。 所以line manager破格給了我一個機會，讓我非常珍惜愧沟。

剛開始入職蔬咬，面對全新的工作，我是心虛的沐寺。技術(shù)文檔工程師林艘，是以寫作為載體的工作，但本質(zhì)上混坞，這是一份技術(shù)工作狐援。作為新人钢坦，面對一堆專業(yè)術(shù)語，猶如聽天書啥酱。所幸公司的開發(fā)方式是敏捷開發(fā)爹凹，每天可以在早會上去聽大家的工作匯報，這個時候可以把聽到的不懂的東西記下來镶殷，利用Google這個強大的工具去查禾酱，還有就是用心積累。

首先批钠，經(jīng)過四年的經(jīng)驗宇植，有時候我們經(jīng)歷的產(chǎn)品，可能是一眼望不到邊的埋心，哪怕是開發(fā)人員指郁，也未必完全對系統(tǒng)完全了解其中的功能或玄關(guān)。由于一般都是分組開發(fā)拷呆，很多時候開發(fā)人員只對自己負責的那個模塊比較熟悉闲坎。所以，如果自己一開始不懂茬斧，不要責怪自己腰懂，也不要懷疑自己的智商。

對于產(chǎn)品知識的習得项秉，是日積月累的結(jié)果绣溜。作為文檔工程師，我們只能從日常跟進的每個feature入手娄蔼，了解當下feature的過程中去挖掘系統(tǒng)的其它使用方法怖喻。

當然入職開始，公司一般會安排senior的同事給我們介紹系統(tǒng)和產(chǎn)品總體介紹岁诉。如果沒有足夠的IT背景锚沸，況且senior同事一般都會從技術(shù)層面出發(fā)去介紹，他們的介紹如果難以與writer本身固有的認知聯(lián)系起來涕癣，那些產(chǎn)品知識只能在腦海上空盤旋哗蜈，很難落地化為自己用大白話也能和路人甲說清楚的東西。

剛?cè)肼毮菚购驗樘嗖欢嗯耍乙欢葢岩勺约骸Ｖ車娜怂坪跻惨哉f別人不懂的話只搁，作為一種“高深”和“懂行”的表現(xiàn)绽昼，聽不懂只是聽者的知識儲備問題。

作為writer须蜗，要讓自己的知識儲備跟得上你處在的context, 成為讀懂context的人。

從一開始對自己跟進的系統(tǒng)無從下手，到后面基本能順利安裝和進行各種操作明肮，我經(jīng)歷了以下幾個階段和一些技術(shù)學習的心得體會：

恍惚猶如聽天書：

最開始的進入項目組菱农。我進入的是媒體相關(guān)的內(nèi)容管理系統(tǒng)開發(fā)項目組。 剛開始柿估，對這個行業(yè)和整個系統(tǒng)所處的生態(tài)體系循未，上游下游體系，客戶群體不太了解秫舌。

先跟著開發(fā)節(jié)奏去follow up每個sprint的文檔任務(wù)的妖。可以先幫忙做一些文檔review開始慢慢開始看文檔足陨。 這個過程嫂粟，可以記錄看到的新詞匯，做一些筆記墨缘。

IT圈的開發(fā)人員都熱衷于給自己建立一個在線的筆記星虹，比如OneNote, 有道云筆記，Google Docs等镊讼，隨時隨地積累新知識宽涌。

學習是IT圈的常態(tài)。不管是文檔開發(fā)蝶棋，還是開發(fā)人員卸亮，每接到一個新的需求，計劃開發(fā)任務(wù)玩裙，都例行需要進行quick study兼贸，查閱已有的文檔，看需求文檔献酗，設(shè)計文檔等寝受。如果是開發(fā)涉及到全新的技術(shù)，比如container罕偎，docker等很澄，那必須開展全員學習。有必要時颜及，還需要聘請外援專家甩苛，給內(nèi)部人員進行一定的培訓。

學習的方法很多俏站。Mind Map巧利用讯蒲。

對于未經(jīng)過計算機科班學習出身的technical writer, 缺乏有體系的學習。 這時候肄扎，在排山倒海般的各種術(shù)語中墨林，很有必要建立structured learning in an unstructured surroundings. Mind map是一個很好的辦法赁酝，可以讓我們把知識整理起來，梳理好旭等，并不斷挖掘自己不懂的知識酌呆。

曾經(jīng)的我，沒用過Mind map軟件搔耕，剛開始用時也是比較簡單隙袁，也比較抗拒。 但后來畫幾次mind map之后弃榨，確實這個工具能讓自己的知識積累變得有結(jié)構(gòu)起來菩收。 我給自己專門建立了一個Tech Study的folder，定期學習鲸睛，畫mind map娜饵。

勤分享。越分享腊凶，越進步划咐，這句話在IT圈也是非常行得通。

Sharing是IT工作一個不可或缺的環(huán)節(jié)钧萍，比如code sharing, tech sharing甚至一些testing sharing, 環(huán)境的搭建sharing... 程序員況且如此褐缠，technical writer也可以借鑒。一開始可以讓line manager給自己找一個technical mentor风瘦。

我比較幸運队魏，加入的研發(fā)團隊line manager還是比較支持technical writer的，會配備一些資源讓technical writer更好地學習產(chǎn)品知識万搔。 比如胡桨，讓technical writer定期去分享自己學習的知識，在這個分享session, line manager或其他技術(shù)經(jīng)理瞬雹，會幫忙補充或糾正一些理解昧谊，讓我的理解更充分。

? 第一年的technical writer生涯酗捌，我除了跟著開發(fā)節(jié)奏去學習產(chǎn)品功能呢诬，還定期與Line manager以及我的technical mentor去定期分享自己所學的知識。同時胖缤，我也惡補自己在計算機領(lǐng)域方面的基礎(chǔ)知識尚镰，比如計算機如何處理0和1， 數(shù)據(jù)的類型哪廓，存儲的歷史狗唉，計算機發(fā)展歷史，網(wǎng)絡(luò)知識涡真，域名解析等分俯。

? 所幸我所在的公司肾筐，思康也是一個注重techncal writer持續(xù)學習的公司。每周五都會有writer輪流去分享他們學習的知識澳迫，有趣的技術(shù)前沿知識等局齿。 剛開始輪到我分享時候，我如臨大敵橄登。 一開始總是在絞盡腦汁想自己要分享什么知識，然后挖空心思地去搜索相應(yīng)topic的內(nèi)容讥此，整理ppt拢锹，然后在分享之前還進行rehearsal，然后第二天戰(zhàn)戰(zhàn)兢兢地用英語去介紹自己準備的topic萄喳。計算機技術(shù)本來就是比較抽象卒稳，錯綜復雜，用英文去表達更加深了難度他巨。? 但毫無疑問充坑，這種方式，會逼迫著我們?nèi)W習染突，去用自己的語言把高深的技術(shù)解釋出來捻爷。 我在這個過程準備了computer storage history, message broker, virtualization and container， 每一次準備和分享份企，都讓自己進步很大也榄。 學習最快的途徑，就是把所學分享給其它人司志。所謂“越分享甜紫，懂越多！”

當我們把學習養(yǎng)成了一種工作習慣骂远，定期去學習新知識囚霸，有固定的學習平臺，并養(yǎng)成了一邊學習一邊做筆記激才，不斷豐富自己的技術(shù)知識庫拓型，這樣我們就不再愁technical sharing時要分享什么topic了，很多時候都能信手拈來贸营。在準備sharing時吨述，這個準備過程也相對自如，而不是為了分享而分享的東拼西湊钞脂，可以從自己的知識庫里調(diào)動相關(guān)知識揣云，去梳理整個思路。

作為Technical Writer, 很多時候都是在自己不熟悉的領(lǐng)域冰啃，去學習新產(chǎn)品邓夕，接觸之前可能完全沒背景的行業(yè)刘莹。快速學習新產(chǎn)品和新行業(yè)焚刚，是必要的技能点弯。同時面對新知識，只有掌握了學習之道矿咕，才不會迷失自己抢肛，保持游刃有余。

同時碳柱，學習也不再是古板的教科書式學習〖裥酰現(xiàn)在的網(wǎng)絡(luò)資源，提供了很多自我提升的平臺莲镣。比如一些大學的online open courses, youtube上各種webminar和小視頻福稳，linkedin learning上的課程，udemy等的付費課程瑞侮，不一而足的圆。個人完全可以根據(jù)自己的碎片時間，在繁忙的工作之余半火，保持充電狀態(tài)越妈。

Google也提供了一些快捷學習辦法. Google可以是很好的老師，遇到不懂的術(shù)語慈缔，可以同構(gòu)搜索去挖掘有助于自己理解的咨詢叮称。

身邊的developers也要好好利用下來，跟他們打好關(guān)系藐鹤，不恥下問瓤檐。比如linux的一些操作命令，我剛?cè)胄袝r幾乎一竅不通娱节。在撰寫技術(shù)性比較強的installation guide時挠蛉，會收到很多帶著command的input。 接觸得多了肄满，積累了一些比較常用的命令用法谴古。在跟developer了解Input的過程中，也會了解到一些command的用法稠歉。自己平時再上網(wǎng)查閱linux系統(tǒng)操作的一些用法掰担，找一臺機器上去試著運行幾下，慢慢地就掌握了linux命令的一些實用辦法∨ǎ現(xiàn)在基本對著文檔带饱，我已經(jīng)可以能操作一遍。看到命令勺疼，基本理解這個命令是做什么的教寂，看到可疑的命令，也能提出自己的看法执庐，讓developer去確認input的正確性酪耕。 毫無疑問，在工作中轨淌，我們接觸最多的開發(fā)人員和Product owners們迂烁，在和他們了解Input的過程，能極大促進自己的技術(shù)知識和產(chǎn)品知識猿诸，要特別珍惜和這群人打交道的時間婚被！

作為文科生，面對浩如煙海的IT技術(shù)世界梳虽，可能感到無從下手。一開始往往從自己最擅長和習慣的地方入手灾茁，比如看到術(shù)語記錄下來窜觉，弄清楚每一個術(shù)語的意思，把文檔的術(shù)語庫管理好北专。但這種做法的弊端是禀挫，只從文字表面去理解，缺乏真正理解術(shù)語之間的關(guān)聯(lián)關(guān)系拓颓，很容易斷章取義语婴。 為了避免這種問題，在學習每個術(shù)語時驶睦，也需要了解他們的邏輯關(guān)系砰左。我們必須懂得每一行代碼是怎樣串聯(lián)起來，形成一個代碼repo场航，代碼repo又怎樣被運行起來缠导，在前端變成UI， 在后端如何運作溉痢。同時整個軟件開發(fā)過程中僻造，team與team之間的代碼如何協(xié)作和相互重用，每天如何把代碼build出來等孩饼。

? 網(wǎng)上很多給beginner的編程課髓削，比如學習python或Javascripts。 我認為軟件行業(yè)的technical writers還是很有必要給自己配備一定編程知識镀娶。世界上一流的IT大牛公司招聘technical writer立膛，比如Google，其中有一項要求汽畴，就是面試時讓應(yīng)聘者能讀懂一段代碼旧巾。Technical Writer只有深諳代碼之道耸序，才能算是知道軟件開發(fā)最基本和底層的東西，才能有底氣去往上挖掘更多產(chǎn)品的知識鲁猩。 況且未來社會坎怪，極大可能是人工智能的社會，編程會成為未來一代的基本技能廓握，不會編程如同文盲搅窿。作為Technical Writer，讓自己與世界接軌隙券，成為一個站在技術(shù)前段的酷酷的自己男应，何樂而不為呢。 退而言之娱仔，Technical Writer應(yīng)該有這種追求前沿知識的心態(tài)沐飘，這幾乎可以說是一個職業(yè)的“職業(yè)操守”。

基于這些考慮牲迫，我給自己報了基本的編程課耐朴。這些或免費，或付費的網(wǎng)上課程盹憎，老師在講解的過程中筛峭，也會簡要介紹一些軟件開發(fā)的過程，以及計算機的一些基礎(chǔ)知識陪每。這對與鞏固和加深之前的理解影晓，幫助自己梳理自己的知識體系，非常有幫助檩禾。我也強烈推薦軟件行業(yè)的technical writer挂签，可以給自己設(shè)個小目標，比如三年內(nèi)學會一點編程知識锌订。

我身邊曾經(jīng)合作過一些技術(shù)牛的technical writer竹握，在收到開發(fā)的input后，可以自己去看代碼辆飘；或者有時自己就能通過代碼啦辐，來提取一些input，從而大大提高了寫作效率蜈项∏酃兀　在寫作過程中，對于涉及的一些ｃｏｄｅ相關(guān)的描述紧卒，也能更精準侥衬。

如今，我已經(jīng)在這個崗位做了四年，經(jīng)歷了大大小小的ｒｅｌｅａｓｅｓ轴总，也處理過各種客戶的反饋直颅。對于產(chǎn)品的理解，我已經(jīng)能從前段介紹到后端怀樟，能以客戶的身份操作界面功偿，也能以ｓｅｒｖｉｃｅ維護人員的身份去安裝一個龐大的系統(tǒng)。對于文檔的駕馭往堡，也到了得心應(yīng)手的階段械荷。從一開始對整個項目組的文檔如同云里霧里，到現(xiàn)在我?guī)缀趿巳缰刚坡腔遥牢臋n的每一個出處和改動過程吨瞎。從剛近來那么怯生生和對技術(shù)一種天然的恐懼感，到現(xiàn)在幾乎變成了一個“技術(shù)控”穆咐〔鳎　從剛加入聽大家開會不知所云，到現(xiàn)在可以和大家一起開ｐｌａｎｎｉｎｇ《耘取ｇａMe着绊，聽大家討論技術(shù)細節(jié)和實現(xiàn)方式，也能提一點大家可能不知道的產(chǎn)品背景熟尉，被會議組織者邀請發(fā)表自己的見解，這是一個質(zhì)的飛躍洲脂。

成功轉(zhuǎn)行ｔｅｃｈｎｉｃａｌ〗锒ｗｒｉｔｅｒ?qū)ψ约旱男愿窈蜕钜灿袠O大的改變。首先恐锦，在大學時代的我往果，遇到電腦的任何問題，都會請教男同學一铅；遇到前沿的科技陕贮，會膽怯，不敢去接觸潘飘“怪　現(xiàn)在的我，對于科技卜录，有了更多淡定戈擒。家里的電腦壞了，自己會對著說明書艰毒，或打開ｂａｉｄｕ找到解決的辦法筐高，自己去拆主機去修理。日常一些軟件問題，自己也能通過ｇｏｏｇｌｅ去處理柑土，而無需勞煩自己的家人蜀肘。家里的電視機有什么新功能，我自己也饒有興趣地去鉆研他們的說明書稽屏，使用那些新功能扮宠，讓自己的家居生活也多了一些高科技的色彩。孩子們都能享受到一個懂科技的媽媽帶來的好處诫欠。比如他們上網(wǎng)課涵卵，我可以讓幫他們投屏到電視上去互動，也可以找到很多國外的科技視頻給他們觀看荒叼，讓他們也變得國際化轿偎。家里購置了什么新玩意兒，我都能對著說明書安裝起來被廓，有時還會對著別的產(chǎn)品的說明書評頭品足坏晦。科技嫁乘，真的沒有之前想得那么遙遠和望而生畏昆婿！

現(xiàn)在的自己，已經(jīng)把科技學習融入到自己生活的方方面面蜓斧。我已經(jīng)在向著“技術(shù)”的大道上樂此不疲地奔跑著仓蛆，并享受著科技和這種學習的思維帶來的好處！挎春！我深知看疙，這是一次正確的轉(zhuǎn)行。每天工作八個小時直奋，我可以心無旁騖能庆。每一次ｒｅｌｅａｓｅ，我都可專心致志地仔細閱讀每一本文檔脚线，修改每一處ｃｏｍｍｅｎｔｓ搁胆。難道這就是所謂得“心流”？　一種不為名邮绿，不為利渠旁，能把自己的優(yōu)點和性格優(yōu)勢發(fā)揮到極致的工作？或許是的斯碌，非常慶幸這幾年的積累和摸爬滾打一死。