目前階段:
「2019 年文件季別」計畫已於 2020 年 3 月 6 日結束。請參閱時間表。
參與《The Season of Docs》季的機構管理員有特定責任,為
參與《文件季節》的開放原始碼導師,也有責任各自為自己的開放原始碼機構、技術文件撰寫者和 Google 計畫管理員負責。
本文件說明所有參與的開放原始碼機構應負的責任。個別機構可能還有其他角色和責任。如要瞭解詳情,請洽詢貴機構的管理團隊。
機構管理員的責任
這些是開放原始碼機構中管理員的職責。
您對 Google 的責任
- 定義組織參與、組織選擇標準和機構專用作業程序
- 提交機構申請並擔任機構代表
- 擔任 Google 的溝通聯絡
- 在 36 小時內回覆 Google 洽詢的所有問題
- 檢舉違反《參與者協議》的行為 (例如騷擾、抄襲、詐欺)
- 回報技術文件撰寫者撤回的情況
- 確保工作期限符合所有要求,例如輔導員評估作業、機構應付憑據
- 挑選並邀請值得信賴、有能力且合格的導師
- 提供並維護足夠的專案和任務構想清單
- 監督所有導師和技術文件撰寫專員的活動,確保責任實現責任
你對導師的責任
- 定義組織成員參與、輔導要求、失敗流程和程序
- 在計畫開始前告知導師期望的事項
- 說明技術文件撰寫者的選擇、繼續參與,以及拒絕政策
- 提供文件季別分配的選取條件
- 說明《參與者協議》違反與失敗的處理方式
- 持續評估導師與技術撰寫專員的互動情形
- 識別利益衝突、人際問題,並視需要更換導師
- 讓導師知道需要更多工作或專案構想
- 在計畫前後持續與導師定期溝通
- 務必提供充分且適當的輔導服務,特別是在假日附近
你對技術撰寫者的責任
- 讓技術文件撰寫專員瞭解機構管理員該以何種方式、時機及原因聯絡
- 確保技術文件撰寫專員已具備適當整合能力
- 傳達機構特定要求 (例如時間、程式設計、通訊、授權)
- 傳達機構專屬的期望 (例如行為、最佳做法、瀏覽權限)
- 說明期限、接受條件和失敗/關閉政策
- 監控通訊內容,確保所有不當行為都獲得解決
- 確保技術文件撰寫者可能會提前收到通知
導師的責任
這些是開放原始碼機構中導師的責任。
為開放原始碼機構負的責任
- 說明時間安排和互動期望
- 盡早在指導能力減少 (例如家庭、健康、休假) 時發出通知
- 在技術文件撰寫專員發生問題時通知您,包括:
- 缺乏溝通、活動、瀏覽權限或進度
- 違反《參與者協議》規定 (例如抄襲、騷擾、詐欺)
- 不符合專案需求,或是卸任
- 正式評估技術文件撰寫者的參與情況。
- 在將專案標示為失敗前,先與機構管理員和技術寫入者聯絡
對技術文件撰寫者的責任
這些責任是對您要指導的技術寫作人員負責:
- 協助及/或教導技術文件撰寫者如何
- 成為社群的一分子
- 更有效率地與開放式溝通
- 與貴機構偏好的通訊管道 (IRC、Slack 等) 合作
- 使用貴機構的版本管控系統
- 提出好問題,並且獲得問題的解答
- 提供有說服力的技術論點和建設性討論
- 激勵自己並保持工作效率
- 解決棘手的技術問題
- 隨時掌握進度,讓技術文件撰寫者瞭解他們的狀態
- 定期溝通交流:
- 每週至少定期交流兩次
- 在 24 小時內回覆問題 (在 36 小時內也沒問題)
- 提供具建設性的意見、耐心等待並保持尊重
- 建立實際可行的工作目標和時程期望
- 在明顯超前或落後預期時,與技術文件撰寫專員重新評估範圍
- 與開發人員和社群合作, 以便接受技術撰寫者的工作