- Uber 工程團隊中的技術作家
- 技術作家究竟做什麼？
- 技術作家最大的挑戰是什麼？
- 關於技術寫作最大的誤解是什麼？
在本文中，Uber 前實習生 Shannon Brown 介紹了她作爲技術作家的工作情況，並回答了 Uber 工程團隊中有關這一重要角色的常見問題。
- 原標題：Seven Things to Know about Technical Writing at Uber
- 鏈接：https://eng.uber.com/technical-writing-uber
- 作者：Shannon Brown
- 發表時間：October 3, 2018
就在一年多前，我第一次走進 Uber 舊金山辦事處。開始了爲期 12 周的實習生活，我將開始瞭解技術寫作的世界但我當時不知道會發生什麼。
有些問題其實一直縈繞在我耳邊，例如技術作家的工作究竟是做什麼？我想長期在 Uber 工作嗎？在整個實習期間，這些問題的答案變得越來越清晰。我在夏天實習期結束時找到了答案並且確信這就是我想要追求的道路，我最終選擇並且非常高興接受這份工作。
在大學畢業後選擇工作時，我面臨的問題從來不是我想做什麼？而是我怎麼能完成所有這些事情呢？我一直在尋找一份能夠讓我發揮創造力和分析能力的工作。我期望自己能從事很酷的技術創新，但我對編寫代碼並不感興趣。我希望有一份工作可以每天都有意外驚喜並且能夠持續學習。Amazingly, technical writing checked every box.
技術寫作可能是一種被誤解的職業，所以我將自己的經歷提煉成了七個常見問題。希望未來的作家和技術專家能獲益。
技術作家究竟做什麼？
儘管進行了數小時的在線學習，但直到我的實習走向深入並處理了大量激動人心的項目，才終於理解技術作家的工作。
通常，技術作家記錄由工程師構建的服務或產品。該文檔將有助於新用戶理解產品，傳播有關服務如何工作的信息，並將技術術語翻譯成易於理解的文章。但是，文檔工作只是技術作家的諸多任務之一。除了記錄，技術作家還可以創建培訓材料，分析數據，訪問用戶，編寫產品案例，並提出信息架構問題的解決方案。有些日子你必須像工程師一樣思考，而其他人則像項目經理一樣。這項工作充滿活力，充滿挑戰，而且收穫頗豐。
技術作家最大的挑戰是什麼？
作爲 Uber 的技術作家，我同時與多個項目的多個團隊合作，這一工作模式需要頻繁的上下文切換和多任務處理 — 有時是一個挑戰！爲了確保我能夠在最後期限之前保持最佳狀態併爲我合作的團隊服務，我必須保持高效率和時間計劃的有條不紊。
因爲我與多個團隊合作，所以我也有很大的機會發揮影響力。這是非常有益的，因爲我編寫的文檔和創建的學習內容可以幫助我的同事更快地理解、處理和學習信息 — 這對於 Uber 工程效率和生產力來說是一個巨大的幫助。
關於技術寫作最大的誤解是什麼？
由於技術寫作不是一個超級知名的職業道路，因此存在許多誤解。最讓我印象深刻的說法是技術寫作很無聊。
這是完全錯誤的（除非你討厭閱讀和寫作，並且希望與酷炫技術無關）。
事實上，這項工作非常有趣。正如我之前提到的，需要同時研究這麼多有趣的項目。如果我對一個人感到厭倦，可以換另一個人休息幾個小時。這樣我可以保持參與度，也就不會覺得工作無聊。
關於技術寫作的另一個主要誤解是必須具備技術背景。正如您將在下一節中讀到的那樣，這也是錯誤的！
是否需要工程學位/背景才能成爲技術作家？
許多人認爲需要工程學位/背景才能成爲技術作家，這實際上是另一個很大的誤解。
我再大學裏課程包括計算機科學，音樂和藝術。雖然計算機科學課程有助於理解技術概念，但我的教育中最有用的方面實際上是學習如何學習和傾聽。在學校學習的一些技術工具和概念有助於我作爲技術作家的角色，但最重要的是，他們引導我快速學習並提出問題，這對於科技寫作工作至關重要。
技術作家來自不同的背景，你決不需要工程學位或背景來開始這個領域（儘管它肯定沒有害處！）。如果有很強的寫作技巧和學習的願望，技術寫作可能非常適合你。
爲什麼喜歡在 Uber 擔任技術作家？
無論您處於職業生涯的哪個階段，或者擁有什麼職位，都必須考慮所在公司是否與您的目標和價值觀一致。
在 Uber 工作最好的部分是人。無論是作爲實習生還是全職員工，當第一次加入團隊時，我的團隊成員都竭盡全力歡迎並指導我 — 對我的團隊來說對其他人也是如此。我在 Uber 遇到的每個人都對他們的工作充滿熱情，熱情和熱情。辦公室的能量具有傳染性，強烈的社區意識和自豪感使我每天都期待上班。
我很喜歡 Uber 是一個可以通過向上和橫向流動來建立自己職業生涯的地方。我的一位同事剛剛從技術作家角色轉變爲軟件工程師角色，另一位同事轉變爲項目經理角色，都在 Uber 內部完成轉變。我欣賞 Uber 對於崗位流動性的支持態度。
特別是從技術寫作的角度來看，我認爲優步是一家偉大的公司。我得到了各級管理層的支持，他們真正看到了技術寫作的價值。感謝這種支持，我知道我的工作很重要。當我的工作項目遇到挑戰時，這有助於讓我保持積極性。
最後，成爲 Uber 家族的一員讓我很興奮，因爲我們所做的工作不僅影響了現在，也影響了未來。我很高興能成爲一家正在改變交通運輸業的公司一員。
與其他組織相比，Uber 的技術寫作有何不同？
因爲我的行業經驗有限，所以我徵求了 Uber 技術作家的幫助，以此來討論這個話題。
高級技術作家亞當·帕夫拉卡（Adam Pavlacka）：Uber 非常重視引導工程師撰寫並真正鼓勵良好文檔的工作文化。雖然許多公司只聘請作家提供文檔或從工程師的筆記中抄寫原始副本，但 Uber 聘請的技術作家會以更加親力親爲的方式學習他們正在撰寫的主題。
給有志於成爲技術作家的最大建議是什麼？
如果您想成爲技術作家，請立即開始寫作！您不需要正式工作來練習技術寫作技巧。查找有關您使用的產品或應用的現有文檔，並瞭解如何改進它。與需要文檔幫助的開源項目一起工作。查看有關激動人心技術概念的在線教程。這些小步驟將有助於建立您的投資組合並發展您的技能。
如果你認爲自己不夠“技術人員”或者不適合技術作家的模式，也不要放棄成爲技術作家的想法。條條大路通羅馬！如果您有志於成爲技術作家，請遵循您內心的願望走向成功。