機構管理員指南

目前階段：
結果公布時程。

本指南適用於申請或參與「文件季度」計畫的機構管理員。

貴機構是否應該參加 Google 文件季度計畫？

這些問題能幫助您瞭解開放原始碼專案或機構是否應參與文件季度。

貴機構或專案：

  • 是否相信全新或更新過的說明文件有助於達成目標，或解決專案或社群中的問題？
  • 您對如何評估說明文件專案成效的初步瞭解或假設，需要初步瞭解？
  • 社群成員是否願意協助招募、評估及培訓技術文件撰寫專員，在專案期間 (6-8 個月，包括申請期間) 還有誰能回答問題並提供其他支援？
  • 社群成員是否願意擔任機構管理員，協調建立報名事宜、回應計畫管理員的問題，並提交每月自我評量和最終評估和個案研究？等文件季度結束後，機構管理員也必須願意參與後續的問卷調查。

貴機構也應符合計畫資格規定，包括能夠建立 Open Collective 帳戶。

機構申請程序

「探索」階段

雖然 Google 文件季度應用程式將於 2022 年 2 月 23 日開放申請，但我們強烈建議機構在提交申請前，先花一些時間完成探索階段中的步驟。

  • 建立專案提案頁面。提案頁面會列出重要需求、目標或問題、可能的說明文件解決方案，以及可能的指標。這個頁面應公開，並允許社群協力貢獻和討論。並提供有意參與技術的技術作家資訊，他們應該在哪裡提問、表達興趣或進一步瞭解您的專案？建議您新增電子郵件地址，以便與開放原始碼組織聯絡，瞭解文件季別。不過，我們強烈建議您不要使用個人電子郵件地址做為與開放原始碼組織聯絡的電子郵件地址。(如需範例，請參閱專案提案清單)。
  • 在社群頻道中公開您的提案頁面，並將貴機構新增至 Google 文件季別 GitHub 存放區中感興趣的機構清單中。我們也建議您在「撰寫文件 Slack」的 #season-of-docs 頻道中分享連結。促銷和新聞頁面包含標誌和其他內容，可供您在提及文件季度時使用。
  • 針對每個說明文件構想，請考慮與社群和機構合作的技術寫入者俱備哪些經驗和資格。您的社群能夠協助技術文件撰寫專員培養哪些技能 (例如，使用 GitHub 或您的文件工具鍊)？(請參閱與技術文件撰寫專員合作指南。
  • 徵求自願者協助回答感興趣的技術撰寫者提出的問題。
  • 請檢閱所有有興趣參與專案的技術撰寫者提交的聲明。

申請階段

  • 從提案網頁中選擇最具潛力的提案。每個機構組織只能提交一個提案。請考量以下事項：
    • 技術作家最關注哪個構想？
    • 哪種想法有助於解決專案最棘手的問題？與其對較可能完成、但不會對專案造成重大影響的文件專案，選擇較具風險的意識。
    • 實現這個創意的想法 要邀請社群的特定成員參與嗎？他們是否有時間參加？

  • 使用提案範本建立提案。 請務必瞭解並提供下列資訊：

    • 您想解決的問題
    • 您要改善或建立的說明文件範圍
    • 您將如何評估說明文件成效

    提案也必須包含預算。 我們不會將不完整的提案納入考量。

  • 請在世界標準時間 2022 年 3 月 25 日 18:00 前提交申請表。我們將於 2022 年 4 月 14 日公布已接受的提案。

專案開發與報告

專案啟動

  • 如果貴機構已為您的專案選擇技術文件撰寫者或撰寫者，請與技術文件撰寫專員進行開會。建議你與技術文件撰寫專員合作，建立作品時間表和定期檢查進度。
  • 如果您已經收到相關技術作家的多次聲明，可以公開宣布您選擇的技術作家，或告知申請者您的決定。

授權款項

  • Google 文件季別將自 2022 年 6 月 9 日起，將受僱技術文件撰寫專員的 40% 資金存入各個機構的開放收集帳戶。我們建議機構根據專案里程碑 (包括專案啟動時的付款情形) 與技術文件撰寫專員訂立付款時間表。
  • 自 2022 年 12 月 14 日起，完成並提交最終評估與個案研究的機構，剩餘的 60% 將發放到該機構的 Open Collective 帳戶。請注意，無論專案完成時程為何 (例如 3 個月或者專案完成 6 個月)，所有成功的專案都會自 2022 年 12 月 14 日開始收到最後一筆款項
  • 如要進一步瞭解如何建立 Open Collective 帳戶，請參閱付款指南。

專案狀態回報

  • 機構管理員應在收到狀態報告表單連結後的一週內填寫每月狀態報告 (連結會透過電子郵件傳送，因此請查看垃圾郵件資料夾)。

專案最終評估與個案研究

申請機構必須在世界標準時間 2022 年 11 月 30 日 18:00 前完成並提交專案最終評估和個案研究，才能獲得剩餘的補助金。

最終評估

最終評估表單將於世界標準時間 2022 年 11 月 30 日 18:00 前一個月提供給機構管理員。

個案研究

「文件季度」個案研究是貴機構在 Google 文件季度參與的重要交付項目。保留每週專案更新內容記錄有助於製作個案研究。每週記錄專案進度 (包括提取要求、問題或對話的連結 (如適用)、內容良好 (或不適用)、學到的知識，以及提問內容)。

詳情請參閱「建立個案研究」一文，並請務必使用我們的個案研究範本製作個案研究。在最終評估表單中，會以連結的形式提交個案研究。

您的個案研究會發布在文件季別網站，因此在加入專案相關資訊時，請特別留意。

機構必須參與至少三份後續問卷調查，協助我們追蹤文件季度專案是否持續成功。

表單

表單 連結 期限
機構申請

機構申請現已結束。在 season-of-docs-announce 中加入公告郵寄清單，隨時掌握最新消息。

 世界標準時間 2022 年 3 月 25 日 18:00
機構付款資訊

目前尚未提供這份表單。

 世界標準時間 2022 年 5 月 12 日 18:00
技術文件撰寫人員招聘的證明

技術文件撰寫者招聘階段結束。

 世界標準時間 2022 年 5 月 16 日 18:00
每月評估

每月評估階段已結束。

 查看時間表
最終專案評估與個案研究

專案評估階段已結束。

 世界標準時間 2022 年 11 月 30 日 18:00
後續問卷調查

將於後續問卷調查階段 (2023 年 5 月 2 日) 提供表單。

 查看時間表