- Uber 工程團隊中的技術(shù)作家
- 技術(shù)作家究竟做什么污抬？
- 技術(shù)作家最大的挑戰(zhàn)是什么？
- 關(guān)于技術(shù)寫作最大的誤解是什么绳军？
在本文中印机，Uber 前實習(xí)生 Shannon Brown 介紹了她作為技術(shù)作家的工作情況，并回答了 Uber 工程團隊中有關(guān)這一重要角色的常見問題门驾。
- 原標(biāo)題：Seven Things to Know about Technical Writing at Uber
- 鏈接：https://eng.uber.com/technical-writing-uber
- 作者：Shannon Brown
- 發(fā)表時間：October 3, 2018
就在一年多前射赛，我第一次走進 Uber 舊金山辦事處。開始了為期 12 周的實習(xí)生活奶是，我將開始了解技術(shù)寫作的世界但我當(dāng)時不知道會發(fā)生什么楣责。
有些問題其實一直縈繞在我耳邊，例如技術(shù)作家的工作究竟是做什么聂沙？我想長期在 Uber 工作嗎秆麸？在整個實習(xí)期間，這些問題的答案變得越來越清晰及汉。我在夏天實習(xí)期結(jié)束時找到了答案并且確信這就是我想要追求的道路沮趣，我最終選擇并且非常高興接受這份工作。
在大學(xué)畢業(yè)后選擇工作時坷随，我面臨的問題從來不是我想做什么房铭？而是我怎么能完成所有這些事情呢驻龟？我一直在尋找一份能夠讓我發(fā)揮創(chuàng)造力和分析能力的工作。我期望自己能從事很酷的技術(shù)創(chuàng)新缸匪，但我對編寫代碼并不感興趣翁狐。我希望有一份工作可以每天都有意外驚喜并且能夠持續(xù)學(xué)習(xí)。Amazingly, technical writing checked every box.
技術(shù)寫作可能是一種被誤解的職業(yè)豪嗽，所以我將自己的經(jīng)歷提煉成了七個常見問題。希望未來的作家和技術(shù)專家能獲益豌骏。
技術(shù)作家究竟做什么龟梦？
盡管進行了數(shù)小時的在線學(xué)習(xí)，但直到我的實習(xí)走向深入并處理了大量激動人心的項目窃躲，才終于理解技術(shù)作家的工作计贰。
通常，技術(shù)作家記錄由工程師構(gòu)建的服務(wù)或產(chǎn)品蒂窒。該文檔將有助于新用戶理解產(chǎn)品躁倒，傳播有關(guān)服務(wù)如何工作的信息，并將技術(shù)術(shù)語翻譯成易于理解的文章洒琢。但是秧秉，文檔工作只是技術(shù)作家的諸多任務(wù)之一。除了記錄衰抑，技術(shù)作家還可以創(chuàng)建培訓(xùn)材料象迎，分析數(shù)據(jù)，訪問用戶呛踊，編寫產(chǎn)品案例砾淌，并提出信息架構(gòu)問題的解決方案。有些日子你必須像工程師一樣思考谭网，而其他人則像項目經(jīng)理一樣汪厨。這項工作充滿活力，充滿挑戰(zhàn)愉择，而且收獲頗豐劫乱。
技術(shù)作家最大的挑戰(zhàn)是什么？
作為 Uber 的技術(shù)作家锥涕，我同時與多個項目的多個團隊合作要拂，這一工作模式需要頻繁的上下文切換和多任務(wù)處理 — 有時是一個挑戰(zhàn)！為了確保我能夠在最后期限之前保持最佳狀態(tài)并為我合作的團隊服務(wù)站楚，我必須保持高效率和時間計劃的有條不紊脱惰。
因為我與多個團隊合作，所以我也有很大的機會發(fā)揮影響力窿春。這是非常有益的拉一，因為我編寫的文檔和創(chuàng)建的學(xué)習(xí)內(nèi)容可以幫助我的同事更快地理解采盒、處理和學(xué)習(xí)信息 — 這對于 Uber 工程效率和生產(chǎn)力來說是一個巨大的幫助。
關(guān)于技術(shù)寫作最大的誤解是什么蔚润？
由于技術(shù)寫作不是一個超級知名的職業(yè)道路磅氨，因此存在許多誤解。最讓我印象深刻的說法是技術(shù)寫作很無聊嫡纠。
這是完全錯誤的（除非你討厭閱讀和寫作烦租，并且希望與酷炫技術(shù)無關(guān)）。
事實上除盏，這項工作非常有趣叉橱。正如我之前提到的，需要同時研究這么多有趣的項目者蠕。如果我對一個人感到厭倦窃祝，可以換另一個人休息幾個小時。這樣我可以保持參與度踱侣，也就不會覺得工作無聊粪小。
關(guān)于技術(shù)寫作的另一個主要誤解是必須具備技術(shù)背景。正如您將在下一節(jié)中讀到的那樣抡句，這也是錯誤的探膊！
是否需要工程學(xué)位/背景才能成為技術(shù)作家？
許多人認(rèn)為需要工程學(xué)位/背景才能成為技術(shù)作家待榔，這實際上是另一個很大的誤解突想。
我再大學(xué)里課程包括計算機科學(xué)，音樂和藝術(shù)究抓。雖然計算機科學(xué)課程有助于理解技術(shù)概念猾担，但我的教育中最有用的方面實際上是學(xué)習(xí)如何學(xué)習(xí)和傾聽。在學(xué)校學(xué)習(xí)的一些技術(shù)工具和概念有助于我作為技術(shù)作家的角色刺下，但最重要的是绑嘹，他們引導(dǎo)我快速學(xué)習(xí)并提出問題，這對于科技寫作工作至關(guān)重要橘茉。
技術(shù)作家來自不同的背景工腋，你決不需要工程學(xué)位或背景來開始這個領(lǐng)域（盡管它肯定沒有害處！）畅卓。如果有很強的寫作技巧和學(xué)習(xí)的愿望擅腰，技術(shù)寫作可能非常適合你。
為什么喜歡在 Uber 擔(dān)任技術(shù)作家翁潘？
無論您處于職業(yè)生涯的哪個階段趁冈，或者擁有什么職位，都必須考慮所在公司是否與您的目標(biāo)和價值觀一致。
在 Uber 工作最好的部分是人渗勘。無論是作為實習(xí)生還是全職員工沐绒，當(dāng)?shù)谝淮渭尤雸F隊時，我的團隊成員都竭盡全力歡迎并指導(dǎo)我 — 對我的團隊來說對其他人也是如此旺坠。我在 Uber 遇到的每個人都對他們的工作充滿熱情乔遮，熱情和熱情。辦公室的能量具有傳染性取刃，強烈的社區(qū)意識和自豪感使我每天都期待上班蹋肮。
我很喜歡 Uber 是一個可以通過向上和橫向流動來建立自己職業(yè)生涯的地方。我的一位同事剛剛從技術(shù)作家角色轉(zhuǎn)變?yōu)檐浖こ處熃巧盗疲硪晃煌罗D(zhuǎn)變?yōu)轫椖拷?jīng)理角色坯辩，都在 Uber 內(nèi)部完成轉(zhuǎn)變。我欣賞 Uber 對于崗位流動性的支持態(tài)度病毡。
特別是從技術(shù)寫作的角度來看濒翻，我認(rèn)為優(yōu)步是一家偉大的公司屁柏。我得到了各級管理層的支持啦膜，他們真正看到了技術(shù)寫作的價值。感謝這種支持淌喻，我知道我的工作很重要僧家。當(dāng)我的工作項目遇到挑戰(zhàn)時，這有助于讓我保持積極性裸删。
最后八拱，成為 Uber 家族的一員讓我很興奮，因為我們所做的工作不僅影響了現(xiàn)在涯塔，也影響了未來肌稻。我很高興能成為一家正在改變交通運輸業(yè)的公司一員。
與其他組織相比匕荸，Uber 的技術(shù)寫作有何不同爹谭？
因為我的行業(yè)經(jīng)驗有限，所以我征求了 Uber 技術(shù)作家的幫助榛搔，以此來討論這個話題诺凡。
高級技術(shù)作家亞當(dāng)·帕夫拉卡（Adam Pavlacka）：Uber 非常重視引導(dǎo)工程師撰寫并真正鼓勵良好文檔的工作文化。雖然許多公司只聘請作家提供文檔或從工程師的筆記中抄寫原始副本践惑，但 Uber 聘請的技術(shù)作家會以更加親力親為的方式學(xué)習(xí)他們正在撰寫的主題腹泌。
給有志于成為技術(shù)作家的最大建議是什么？
如果您想成為技術(shù)作家尔觉，請立即開始寫作凉袱！您不需要正式工作來練習(xí)技術(shù)寫作技巧。查找有關(guān)您使用的產(chǎn)品或應(yīng)用的現(xiàn)有文檔侦铜，并了解如何改進它绑蔫。與需要文檔幫助的開源項目一起工作运沦。查看有關(guān)激動人心技術(shù)概念的在線教程。這些小步驟將有助于建立您的投資組合并發(fā)展您的技能配深。
如果你認(rèn)為自己不夠“技術(shù)人員”或者不適合技術(shù)作家的模式携添，也不要放棄成為技術(shù)作家的想法。條條大路通羅馬篓叶！如果您有志于成為技術(shù)作家烈掠，請遵循您內(nèi)心的愿望走向成功。
