本頁針對 Google 系列文件接受的技術撰寫專案提供詳細資料。
專案摘要
- 開放原始碼機構：
- Linux 基金會
- 技術文件撰寫者：
- 小亞
- 專案名稱：
- CHAOSS D&I 徽章專案製作文件
- 專案長度：
- 標準長度 (3 個月)
Project description
主要內容如下： 主要目標是在工作流程中充實文件相關作品、撰寫社群面的 D&I 徽章文件，並在專業平台上代管多語言處理的說明文件。這些文件可分為以下微型任務： 使用更多 D&I 指標，更新並整合目前的公關範本，以及運用更多 D&I 指標和多元問題。 草擬概念總覽，介紹 D&I 徽章計畫 使用 JOSS 文件草擬申請者準則，做為參考。一份參考文件，說明整個工作流程的不同角色和各自責任。解釋如何將 GitHub 專業機器人應用於工作流程的文件 貢獻者指南，說明新手可以如何參與專案或文件。 協助文件的翻譯工作、檢查自動翻譯的效能 (尤其是中文)，並視需要手動翻譯。 根據翻譯成果，以多種語言整理說明文件。使用 Gitbook、閱讀文件或 GitHub Wiki 託管文件。
交付項目 1. 使用更多指標和多元問題來充實專案和活動公關範本。交付項目包括工作流程中所有的文件相關工作，尤其是供申請者完成的公關範本。這正是工作流程的核心要素，因為這項元素在審查人員的評估中具有顯著的功用，因此整個工作流程的表單和問題內容能完美融入整個工作流程，而我將從更多類型的活動或專案著手，再從多個面向來解答問題：
交付項目 2. 下方為社群適用的說明文件結構草稿
D&I 徽章結構總覽
簡介
目標
徽章等級
申請活動徽章
活動 PR 範本
申請專案徽章
專案 PR 範本
審核
如何成為審查人員
「如何成為審核人員」和「公關操作」- 查看徽章衝突政策
審查準則與公關行為
審查準則
交付項目 3. 以多種語言整理文件，並在「閱讀說明文件」或「GitHub」等平台代管文件。
在目前的工作流程中，我正在研究部分自動翻譯功能，並協助確認翻譯結果的繁體中文版本，例如翻譯的正確性和流暢度。 文件將採用單一格式，我會調查技術文件代管平台 (例如閱讀說明文件、Gitbook 和 GitHub 維基)，並選擇最適合用來代管開放社群開放文件的平台。