導師指南

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

本指南適用於開放原始碼導師,成員負責參與文件季別,擔任技術文件寫作輔導者。

簡介

本指南可協助您在文件季度的每個階段執行您所負責的工作。

身為導師的目標之一,就是確保技術撰寫人員在今年的《文件季節》中擁有豐富且成功的經驗。這樣也能增加技術撰寫者在今年文件季節結束之後,持續為您的開放原始碼專案貢獻心力,並且讓其他技術文件作者也樂於使用開放原始碼服務。

機構申請階段

機構申請階段於 2020 年 4 月 13 日至 2020 年 5 月 4 日。機構組織管理員在這段期間內可以提交申請,讓貴機構參加「各季文件」計畫。Google 計畫管理員會在 2020 年 5 月 11 日發布成功的機構清單。

你在這個階段的任務為輔導員

建立提案清單。

與機構管理員合作,建立專案構想清單。這份清單應包含一或多個文件專案,可讓技術文件撰寫者在今年的「文件季」中解決這些問題。

技術寫作專案構想

註冊觀看第 1 季文件。

盡快報名文件季。

2020 季 Google 文件報名已截止。

討論文件季度。

請大力宣傳貴機構參加年度文件活動!即使貴機構今年未列入核可的組織清單,依然是好消息,因為貴公司今年沒有入選資格。

宣傳素材

技術文件撰稿人探索階段

技術撰寫者探索階段的執行時間為 2020 年 5 月 11 日至 6 月 8 日。在這段期間,技術文件撰寫者會探索參與機構的清單和各機構的專案構想。技術文件撰寫者可能會直接與一或多個機構聯絡,討論專案構想。

你在這個階段的任務為輔導員

與感興趣的技術文件撰寫專員討論專案構想。

您可與任何直接接觸貴機構的技術文件撰寫專員討論專案構想,協助技術文件撰寫專員彙整一份優質的專案提案,以便提交給 Google 計畫管理員提交。這些構想可能來自貴機構組織提出的構想,以及技術文件撰寫者提出的其他想法。

技術寫作專案構想

評估技術文件撰寫專員的提案

技術文件文件撰寫階段

技術文件寫入階段為 2020 年 6 月 9 日至 2020 年 7 月 9 日。在這段期間,技術文件撰寫者應申請參與「文件季別」,並且機構選擇要指導的專案。

你在這個階段的任務為輔導員

評估技術撰寫者的提案。

與貴機構管理員合作評估技術寫作提案,並選擇貴機構想在今年文件季期間擔任指導員的技術寫作專案。

評估技術文件撰寫專員的提案

社區凝聚階段

社群凝聚階段於 2020 年 8 月 17 日至 9 月 13 日。在此期間,這些指導者會協助已獲認可的技術撰寫者熟悉開放原始碼專案。

你在這個階段的任務為輔導員

向技術撰寫者介紹開放原始碼專案與社群。

向開放原始碼機構介紹技術撰寫者,並協助技術文件撰寫專員熟悉您使用的工具和程序。

與技術文件撰寫專員合作

您應負的責任

向技術文件撰寫專員說明你的產品。

請花時間說明產品 (尤其是在概念上),並確保技術文件撰寫專員瞭解說明文件的目標對象。

與技術文件撰寫專員合作

設置溝通管道。

鼓勵技術文件撰寫專員在社群郵寄清單、即時通訊、Slack 頻道和其他共用通訊管道中自我介紹。確保技術文件撰寫專員能以可靠的方式直接與您通訊。

您應負的責任

設定目標和期望。

與技術文件撰稿人員合作,修正其技術寫作專案的目標,同時設立雙方對兩方的期望。專案的目標是確保專案能順利完成。

您應負的責任

文件開發階段

文件開發階段的執行期間為 2020 年 9 月 14 日至 2020 年 11 月 30 日。在此期間,技術文件撰寫專員會與他們的導師密切諮詢以完成專案。

你在這個階段的任務為輔導員

建議及鼓勵技術文件撰寫專員。

與技術文件撰寫專員密切合作,確保專案順利完成。

與技術文件撰寫專員合作

您應負的責任

填寫 Google 計畫管理員提供的任何問卷調查。

Google 計畫管理員可能會在專案進行中填寫問卷調查,以便評估進度。按照問卷調查文件中的指示完成問卷調查,並將回答提交給 Google 計畫管理員。

專案完成和評估階段

專案完成階段的期間為 2020 年 12 月 3 日至 10 日。(長時間執行的專案的日期不同)。在此期間,技術文件撰寫者會提交最終的工作產品及其導師評估。

導師評估階段的執行期間為 2020 年 12 月 3 日至 2020 年 12 月 10 日 18:00 (世界標準時間)。在此期間,導師會提交對於技術撰寫專案的成功成果,以及他們與技術撰寫者合作的經驗。

你在這個階段的任務為輔導員

撰寫並提交技術撰寫專案的評估結果。

請在世界標準時間 2021 年 3 月 12 日 18:00 前完成並提交評估作業。

評估技術寫作專案

長時間執行的專案評估階段已關閉。

長時間執行的專案

針對文件季度的標準技術撰寫專案,文件開發階段是從 2020 年 9 月 14 日到 2020 年 11 月 30 日。不過,有些技術寫入者可能會申請長時間執行的專案與開放原始碼機構合作。針對長時間執行的專案,文件開發階段會在 2020 年 9 月 14 日至 2021 年 3 月 1 日間執行。

長期執行專案的專案最終化與評估期間為 2021 年 3 月 1 日至 8 日。在此期間,技術文件撰寫者會提交最終版作品並進行評估,而導師則提交評估內容。

您將工作視為長期執行專案的導師

建議技術文件編寫者並提交專案評估資料。

您的工作和責任與本頁所述,內容與本頁所述內容相同,但專案最終階段和評估的時程更晚。