—

Technical Writier 的價值來自用簡單、直白的語言來解釋複雜的技術。

多數的開發者在寫文件的時候，容易從非常技術的角度撰寫文件 – 多數狀況是「只解釋程式功能，但不解釋程式對於使用者的目的」。由於程式往往有自己的商業邏輯（例如建立訂單的流程、訂單對帳與請款的方式），使用者在不清楚商業邏輯的前提下直接閱讀，往往一頭霧水。

Technical Writer 就是要來解決這個問題。

這個職位結合「內容寫作 (Content writing)」和「技術寫作 (Technical Writing)」的專業，可以將硬梆梆的技術內容、轉換成一般使用者也能好理解的技術+商業內容。

因此我們可以從這兩大面向切入討論。

▋在「內容寫作」上

•敘事能力：使用直白的語言、舉體的例子清楚地敘述一件事情

•編輯能力：將文章內容編排的容易閱讀

•圖解能力：許多概念用文字非常難表達清楚，此時簡單的圖解 (例如流程圖) 能夠協助讀者快速理解概念

▋在「技術寫作」上

•資訊整理能力：自己要能搜集與整理所有可以用到的內容、順好邏輯，才能寫出簡單易讀、流程清楚的文章

•技術能力：除了要跟工程師溝通之外，自己也需要具備基礎的技術能力，例如使用 Github 管理文件版本 (version control)

•組織能力：一份文件的內容組織方式決定了讀者的閱讀體驗

以上是我認為一位 Technical Writer 需要具備的 6 種能力，謝謝提問 !

所以比較好的作法誠如您所言，由PM甚至是測試工程師來執筆是最佳的，但相對會增加這兩個部門的工作量，我還曾經聽某位工程師說：如果我會寫文章，就換我來PM就好啦！！！

如果是默默無聞公司出的，可能是 (1)一張很簡陋的圖示說明 (2)直接印在產品外盒上。

跨國大公司這點做得比較好些，買個消費性電子產品，通常會有一疊(或一本)產品說明書。

不過，有的時候厚厚一本，裡面各國語系都有，翻到繁體中文部分還是很簡陋。

遊戲攻略本超直白~說明書真的要簡單易懂才能解決使用者問題!

想請問原PO擔任 Technical Writer是否有什麼樣的條件具備?