9月15日，廣東技術傳播社區(qū)第二次活動在華僑城另空間順利舉辦。
當天天氣炎熱至酷熱，氣象臺預測超強臺風“山竹”將正面影響深圳。前一天得知“山竹”來勢洶洶，考慮是否調整活動的時間。早上7點多艷陽高照，果斷決定通知報名的小伙伴活動如期進行。
參與這次活動的有新朋友和老朋友。吉祥騰達科技的 Celin ，第二次參加社區(qū)活動，大學畢業(yè)就進入技術傳播行業(yè)，從她的身上能感覺很強烈的學習和探索熱情，是社區(qū)的活躍成員。唐能翻譯的 Joanna 剛從上海來深圳定居，一直從事翻譯的客戶開發(fā)和管理，希望通過活動了解技術傳播行業(yè)。高亞科技的 Jane 一早從廣州出發(fā)，風塵仆仆來到深圳，先和我們打招呼再去找吃飯的地方。大家滿滿的熱情和正能量！
感謝社區(qū)組委會小伙伴阿野為社區(qū)活動找到了一個安靜、寬敞、明亮的聚會地點，同時降低了活動場地費用。
活動的熱場環(huán)節(jié)依舊是自我介紹。無巧不成書—這次活動的同行大多與翻譯行業(yè)有關系。有的正在從事翻譯職業(yè)，有的在翻譯公司開發(fā)客戶和項目管理的，有的是從翻譯轉到技術寫作崗位的。
互動環(huán)節(jié)中，小伙伴們就工作、學習中的關注點（例如：DITA工具的選擇，高校語言專業(yè)的學生的就業(yè)方向，等等）進行了討論和交流。
進入分享環(huán)節(jié)，我先為小伙伴們介紹了使用代碼開發(fā)工具和流程管理文檔的模式。軟件企業(yè)中的文檔團隊采用敏捷模式開發(fā)產品文檔，在內容開發(fā)工具和流程上存在許多“貌合神離”的地方，影響了文檔的交付和質量。
技術文檔如何提高“含金量”，如何讓文檔開發(fā)、管理、發(fā)布過程更“智能”，提高獲取性和可用性？我們可以借用代碼的開發(fā)工具和流程。
使用輕量級標記語言取代專門化寫作工具，降低內容開發(fā)的門檻，工程團隊與文檔團隊協(xié)同開發(fā)內容，分別專注于技術細節(jié)與文檔架構，從而提高技術文檔的“含金量”；文檔評審流程借用代碼評審機制，跟蹤文檔中待改進的問題，激發(fā)評審興趣的同時，提升內容質量；代碼開發(fā)流程的自動化工具應用于質量檢查，減少人工和重復工作，讓內容貢獻者專注于開發(fā)文檔內容；持續(xù)集成和持續(xù)交付工具，定期集成很新版本，一鍵式網站發(fā)布，提高文檔的獲取性和可用性。
國內外的企業(yè)使用文檔代碼化的模式對技術文檔，特別是面向開發(fā)者的文檔、技術支持文檔轉換，收到了不錯的效果，將轉換經驗在Write the Docs 社區(qū)大會和企業(yè)博客分享。
前華為信息架構專家李琳 Emma （公眾號：技術傳播李琳）為大家分享了三個DITA 實施案例。
Emma向大家深入介紹了使用DITA結構化寫作的優(yōu)勢。借用人類演進圖描述了結構化寫作是企業(yè)技術文檔寫作演進歷程中的先進階段，結構化寫作有效地解決了工業(yè)化寫作的痛點。結構化寫作對信息分類，與產品功能和規(guī)格相關的信息以概念類和參考類主題進行描述，指導用戶完成產品操作和排除故障的說明性信息以任務類型進行描述，通過信息分類對內容進行結構化、模塊化。
結構化寫作中按自上而下（Top-down）的架構設計文檔，基于使用場景，設計內容模塊與交付方式，完成內容開發(fā)后，按交付模式發(fā)布。自上而下的信息架構設計保證了實現(xiàn)企業(yè)的業(yè)務價值，有效傳遞產品的設計意圖，提高文檔團隊并行開發(fā)的能力，適應讀者（用戶）的需求變化，提高內容的重復使用能力。
產品信息的開發(fā)貫穿整個產品生命周期。例如，在產品需求分析和整理階段輸出功能清單，設計階段輸出規(guī)格參數(shù)，開發(fā)階段輸出接口說明，維護階段輸出故障排除指導說明。通過內容管理系統(tǒng)設計和定義信息的流動，將內容板塊按需整合為不同類型的手冊（例如：硬件手冊、軟件手冊、操作手冊和維護手冊），以多種格式發(fā)布到交付門戶網站。產品信息在內容管理生態(tài)體系中得到有效的繁衍、管理和使用。
Emma 逐個分析不同的結構化寫作案例中的利與弊。案例一，Microsoft Word中的豐富段落樣式，自定義文檔模板，自帶的語言檢查工具，滿足了文檔團隊從編寫、管理、排版輸出的多方面要求，讓文檔團隊有了“正規(guī)軍”的感覺。使用Word工具維護文檔也有一些不盡人意的地方，例如插圖和排版。案例二，從Word到DITA，從TW的角度看，雖然工具不同了，區(qū)別不大，還是結構化寫作，只是內容和樣式分離了，也需要花費學習成本。案例三，從DITA到內容管理系統(tǒng)，編寫、評審流程更高效了，快速重用內容模塊，文檔管理省時省力，但系統(tǒng)復雜、使用流程工序多，發(fā)布的還是以往的內容。
Emma總結：DITA正在并將會以輕量化、專門化、可視化、云化演進。
然后，我向大家介紹了下半年國內外行業(yè)活動，包括9月中在杭州舉辦的中國技術傳播論壇，11月將在荷蘭鹿特丹舉辦的DITA-OT Day, DITA/CMS歐洲大會以及在德國斯圖加特舉辦的tcworld 2018大會。
活動在愉快的氣氛中結束。希望大家在此次社區(qū)活動中收獲知識。
