團隊術語表(Glossary)的最佳製作方式,是由跨領域溝通的角色主導製作,並由工程師協助審核與補充。
最佳主導角色
產品經理(PM) / 專案經理(PO):
這是最佳人選。PM 處於商業業務與技術團隊的交會點,最清楚非技術人員(行銷、業務、營運)聽不懂哪些術語,同時也理解工程師口中的技術含義,最適合擔綱「翻譯官」。
系統分析師(SA)或技術文案(Technical Writer):若團隊規模較大、有設置這些角色,由他們來彙整架構與撰寫會更為精準。
團隊協作模式(三分分工法)
建立術語表不該是單一人的獨角戲,建議採用以下分工架構:
列出平時開會最常聽到、最困惑的火星文單字(例如:API, CI/CD, Cache, Webhook, DB Locking)。
將技術概念轉譯為「商業語言」或「生活類比」,寫出第一版白話解釋。
檢查白話解釋是否有嚴重偏離技術事實的狀況,確保精準度。
製作與維護小技巧
從「痛點」開始累積:不需要一開始就想寫出百科全書。每次開會只要出現大家聽不懂的詞,
就順手記錄到 Notion、Confluence 或 Google Sheet 中。
採用「三欄式」結構:
術語名稱(例如:API)
工程師的意思(例如:應用程式介面)
白話生活比喻(例如:餐廳的點餐外送員,負責把客人的點單傳給廚房,再把做好的菜送回桌上)