機構管理員和導師的職責

目前階段:
「2019 年文件季別」計畫已於 2020 年 3 月 6 日結束。請參閱時間表

參與《The Season of Docs》季的機構管理員有特定責任,為

參與《文件季節》的開放原始碼導師,也有責任各自為自己的開放原始碼機構、技術文件撰寫者和 Google 計畫管理員負責。

本文件說明所有參與的開放原始碼機構應負的責任。個別機構可能還有其他角色和責任。如要瞭解詳情,請洽詢貴機構的管理團隊。

機構管理員的責任

這些是開放原始碼機構中管理員的職責。

您對 Google 的責任

  • 定義組織參與、組織選擇標準和機構專用作業程序
  • 提交機構申請並擔任機構代表
  • 擔任 Google 的溝通聯絡
    • 在 36 小時內回覆 Google 洽詢的所有問題
    • 檢舉違反《參與者協議》的行為 (例如騷擾、抄襲、詐欺)
    • 回報技術文件撰寫者撤回的情況
  • 確保工作期限符合所有要求,例如輔導員評估作業、機構應付憑據
  • 挑選並邀請值得信賴、有能力且合格的導師
  • 提供並維護足夠的專案和任務構想清單
  • 監督所有導師和技術文件撰寫專員的活動,確保責任實現責任

你對導師的責任

  • 定義組織成員參與、輔導要求、失敗流程和程序
  • 在計畫開始前告知導師期望的事項
  • 說明技術文件撰寫者的選擇、繼續參與,以及拒絕政策
    • 提供文件季別分配的選取條件
    • 說明《參與者協議》違反與失敗的處理方式
  • 持續評估導師與技術撰寫專員的互動情形
    • 識別利益衝突、人際問題,並視需要更換導師
  • 讓導師知道需要更多工作或專案構想
  • 在計畫前後持續與導師定期溝通
  • 務必提供充分且適當的輔導服務,特別是在假日附近

你對技術撰寫者的責任

  • 讓技術文件撰寫專員瞭解機構管理員該以何種方式、時機及原因聯絡
  • 確保技術文件撰寫專員已具備適當整合能力
  • 傳達機構特定要求 (例如時間、程式設計、通訊、授權)
  • 傳達機構專屬的期望 (例如行為、最佳做法、瀏覽權限)
  • 說明期限、接受條件和失敗/關閉政策
  • 監控通訊內容,確保所有不當行為都獲得解決
  • 確保技術文件撰寫者可能會提前收到通知

導師的責任

這些是開放原始碼機構中導師的責任。

為開放原始碼機構負的責任

  • 說明時間安排和互動期望
  • 盡早在指導能力減少 (例如家庭、健康、休假) 時發出通知
  • 在技術文件撰寫專員發生問題時通知您,包括:
    • 缺乏溝通、活動、瀏覽權限或進度
    • 違反《參與者協議》規定 (例如抄襲、騷擾、詐欺)
    • 不符合專案需求,或是卸任
  • 正式評估技術文件撰寫者的參與情況。
    • 在將專案標示為失敗前,先與機構管理員和技術寫入者聯絡

對技術文件撰寫者的責任

這些責任是對您要指導的技術寫作人員負責:

  • 協助及/或教導技術文件撰寫者如何
    • 成為社群的一分子
    • 更有效率地與開放式溝通
    • 與貴機構偏好的通訊管道 (IRC、Slack 等) 合作
    • 使用貴機構的版本管控系統
    • 提出好問題,並且獲得問題的解答
    • 提供有說服力的技術論點和建設性討論
    • 激勵自己並保持工作效率
    • 解決棘手的技術問題
  • 隨時掌握進度,讓技術文件撰寫者瞭解他們的狀態
  • 定期溝通交流:
    • 每週至少定期交流兩次
    • 在 24 小時內回覆問題 (在 36 小時內也沒問題)
  • 提供具建設性的意見、耐心等待並保持尊重
  • 建立實際可行的工作目標和時程期望
  • 在明顯超前或落後預期時,與技術文件撰寫專員重新評估範圍
  • 與開發人員和社群合作, 以便接受技術撰寫者的工作