- Uber 工程團(tuán)隊(duì)中的技術(shù)作家
- 技術(shù)作家究竟做什么？
- 技術(shù)作家最大的挑戰(zhàn)是什么？
- 關(guān)于技術(shù)寫作最大的誤解是什么？
在本文中，Uber 前實(shí)習(xí)生 Shannon Brown 介紹了她作為技術(shù)作家的工作情況，并回答了 Uber 工程團(tuán)隊(duì)中有關(guān)這一重要角色的常見問題。
- 原標(biāo)題：Seven Things to Know about Technical Writing at Uber
- 鏈接：https://eng.uber.com/technical-writing-uber
- 作者：Shannon Brown
- 發(fā)表時(shí)間：October 3, 2018
就在一年多前，我第一次走進(jìn) Uber 舊金山辦事處。開始了為期 12 周的實(shí)習(xí)生活，我將開始了解技術(shù)寫作的世界但我當(dāng)時(shí)不知道會(huì)發(fā)生什么。
有些問題其實(shí)一直縈繞在我耳邊，例如技術(shù)作家的工作究竟是做什么？我想長(zhǎng)期在 Uber 工作嗎？在整個(gè)實(shí)習(xí)期間，這些問題的答案變得越來越清晰。我在夏天實(shí)習(xí)期結(jié)束時(shí)找到了答案并且確信這就是我想要追求的道路，我最終選擇并且非常高興接受這份工作。
在大學(xué)畢業(yè)后選擇工作時(shí)，我面臨的問題從來不是我想做什么？而是我怎么能完成所有這些事情呢？我一直在尋找一份能夠讓我發(fā)揮創(chuàng)造力和分析能力的工作。我期望自己能從事很酷的技術(shù)創(chuàng)新，但我對(duì)編寫代碼并不感興趣。我希望有一份工作可以每天都有意外驚喜并且能夠持續(xù)學(xué)習(xí)。Amazingly, technical writing checked every box.
技術(shù)寫作可能是一種被誤解的職業(yè)，所以我將自己的經(jīng)歷提煉成了七個(gè)常見問題。希望未來的作家和技術(shù)專家能獲益。
技術(shù)作家究竟做什么？
盡管進(jìn)行了數(shù)小時(shí)的在線學(xué)習(xí)，但直到我的實(shí)習(xí)走向深入并處理了大量激動(dòng)人心的項(xiàng)目，才終于理解技術(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)問題的解決方案。有些日子你必須像工程師一樣思考，而其他人則像項(xiàng)目經(jīng)理一樣。這項(xiàng)工作充滿活力，充滿挑戰(zhàn)，而且收獲頗豐。
技術(shù)作家最大的挑戰(zhàn)是什么？
作為 Uber 的技術(shù)作家，我同時(shí)與多個(gè)項(xiàng)目的多個(gè)團(tuán)隊(duì)合作，這一工作模式需要頻繁的上下文切換和多任務(wù)處理 — 有時(shí)是一個(gè)挑戰(zhàn)！為了確保我能夠在最后期限之前保持最佳狀態(tài)并為我合作的團(tuán)隊(duì)服務(wù)，我必須保持高效率和時(shí)間計(jì)劃的有條不紊。
因?yàn)槲遗c多個(gè)團(tuán)隊(duì)合作，所以我也有很大的機(jī)會(huì)發(fā)揮影響力。這是非常有益的，因?yàn)槲揖帉懙奈臋n和創(chuàng)建的學(xué)習(xí)內(nèi)容可以幫助我的同事更快地理解、處理和學(xué)習(xí)信息 — 這對(duì)于 Uber 工程效率和生產(chǎn)力來說是一個(gè)巨大的幫助。
關(guān)于技術(shù)寫作最大的誤解是什么？
由于技術(shù)寫作不是一個(gè)超級(jí)知名的職業(yè)道路，因此存在許多誤解。最讓我印象深刻的說法是技術(shù)寫作很無聊。
這是完全錯(cuò)誤的（除非你討厭閱讀和寫作，并且希望與酷炫技術(shù)無關(guān)）。
事實(shí)上，這項(xiàng)工作非常有趣。正如我之前提到的，需要同時(shí)研究這么多有趣的項(xiàng)目。如果我對(duì)一個(gè)人感到厭倦，可以換另一個(gè)人休息幾個(gè)小時(shí)。這樣我可以保持參與度，也就不會(huì)覺得工作無聊。
關(guān)于技術(shù)寫作的另一個(gè)主要誤解是必須具備技術(shù)背景。正如您將在下一節(jié)中讀到的那樣，這也是錯(cuò)誤的！
是否需要工程學(xué)位/背景才能成為技術(shù)作家？
許多人認(rèn)為需要工程學(xué)位/背景才能成為技術(shù)作家，這實(shí)際上是另一個(gè)很大的誤解。
我再大學(xué)里課程包括計(jì)算機(jī)科學(xué)，音樂和藝術(shù)。雖然計(jì)算機(jī)科學(xué)課程有助于理解技術(shù)概念，但我的教育中最有用的方面實(shí)際上是學(xué)習(xí)如何學(xué)習(xí)和傾聽。在學(xué)校學(xué)習(xí)的一些技術(shù)工具和概念有助于我作為技術(shù)作家的角色，但最重要的是，他們引導(dǎo)我快速學(xué)習(xí)并提出問題，這對(duì)于科技寫作工作至關(guān)重要。
技術(shù)作家來自不同的背景，你決不需要工程學(xué)位或背景來開始這個(gè)領(lǐng)域（盡管它肯定沒有害處?。Ｈ绻泻軓?qiáng)的寫作技巧和學(xué)習(xí)的愿望，技術(shù)寫作可能非常適合你。
為什么喜歡在 Uber 擔(dān)任技術(shù)作家？
無論您處于職業(yè)生涯的哪個(gè)階段，或者擁有什么職位，都必須考慮所在公司是否與您的目標(biāo)和價(jià)值觀一致。
在 Uber 工作最好的部分是人。無論是作為實(shí)習(xí)生還是全職員工，當(dāng)?shù)谝淮渭尤雸F(tuán)隊(duì)時(shí)，我的團(tuán)隊(duì)成員都竭盡全力歡迎并指導(dǎo)我 — 對(duì)我的團(tuán)隊(duì)來說對(duì)其他人也是如此。我在 Uber 遇到的每個(gè)人都對(duì)他們的工作充滿熱情，熱情和熱情。辦公室的能量具有傳染性，強(qiáng)烈的社區(qū)意識(shí)和自豪感使我每天都期待上班。
我很喜歡 Uber 是一個(gè)可以通過向上和橫向流動(dòng)來建立自己職業(yè)生涯的地方。我的一位同事剛剛從技術(shù)作家角色轉(zhuǎn)變?yōu)檐浖こ處熃巧?，另一位同事轉(zhuǎn)變?yōu)轫?xiàng)目經(jīng)理角色，都在 Uber 內(nèi)部完成轉(zhuǎn)變。我欣賞 Uber 對(duì)于崗位流動(dòng)性的支持態(tài)度。
特別是從技術(shù)寫作的角度來看，我認(rèn)為優(yōu)步是一家偉大的公司。我得到了各級(jí)管理層的支持，他們真正看到了技術(shù)寫作的價(jià)值。感謝這種支持，我知道我的工作很重要。當(dāng)我的工作項(xiàng)目遇到挑戰(zhàn)時(shí)，這有助于讓我保持積極性。
最后，成為 Uber 家族的一員讓我很興奮，因?yàn)槲覀兯龅墓ぷ鞑粌H影響了現(xiàn)在，也影響了未來。我很高興能成為一家正在改變交通運(yùn)輸業(yè)的公司一員。
與其他組織相比，Uber 的技術(shù)寫作有何不同？
因?yàn)槲业男袠I(yè)經(jīng)驗(yàn)有限，所以我征求了 Uber 技術(shù)作家的幫助，以此來討論這個(gè)話題。
高級(jí)技術(shù)作家亞當(dāng)·帕夫拉卡（Adam Pavlacka）：Uber 非常重視引導(dǎo)工程師撰寫并真正鼓勵(lì)良好文檔的工作文化。雖然許多公司只聘請(qǐng)作家提供文檔或從工程師的筆記中抄寫原始副本，但 Uber 聘請(qǐng)的技術(shù)作家會(huì)以更加親力親為的方式學(xué)習(xí)他們正在撰寫的主題。
給有志于成為技術(shù)作家的最大建議是什么？
如果您想成為技術(shù)作家，請(qǐng)立即開始寫作！您不需要正式工作來練習(xí)技術(shù)寫作技巧。查找有關(guān)您使用的產(chǎn)品或應(yīng)用的現(xiàn)有文檔，并了解如何改進(jìn)它。與需要文檔幫助的開源項(xiàng)目一起工作。查看有關(guān)激動(dòng)人心技術(shù)概念的在線教程。這些小步驟將有助于建立您的投資組合并發(fā)展您的技能。
如果你認(rèn)為自己不夠“技術(shù)人員”或者不適合技術(shù)作家的模式，也不要放棄成為技術(shù)作家的想法。條條大路通羅馬！如果您有志于成為技術(shù)作家，請(qǐng)遵循您內(nèi)心的愿望走向成功。
