當前階段:
2021 季的文件計畫已於 2021 年 12 月 14 日結束。請參閱時間表。
一般
Google 的「Season of Docs」是招募計畫嗎?
否。如果您有意加入 Google 團隊,請前往 Google 職缺網站。
2021 年 Google 季節性文件有哪些變更?
Google 文件季節 2021 與往年相比有重大變化,包括:
- 技術資料撰寫者不再透過 Google 申請與機構配對
- 申請機構會提交專案提案,作為申請的一部分,包括預算和提案指標
- 獲準的機構會收到補助款,用來支付技術文件撰稿人
- 機構提交最終評估和個案研究
Google 為什麼要進行這些變更?
Google 的使命是彙整全球資訊,供大眾使用,使人人受惠。我們重新聚焦在 Google 文件季的重點,著重介紹開放原始碼的有效文件做法,希望從長遠來看,能帶來更大的影響力。
我們的機構想要參與 2021 年的 Google 文件季,但不知道該從何著手!
歡迎參考完整的專案構想清單!您也可以與技術寫作社群聯絡 (請嘗試在 Write the Docs Slack 或社群媒體管道中,透過 #season-of-docs 頻道尋求協助或提出建議)。
機構可以建議哪些類型的專案?
不妨參考下列建議:
在技術作者和開放原始碼組織決定的平台上建立說明文件網站,並在網站上發布初始的基本文件。平台示例包括:
- 閱讀說明文件
- 靜態網站產生器,例如 Hugo、Jekyll、Sphinx 和其他
- GitHub Pages
重構開放原始碼專案現有的文件,以提供更優質的使用者體驗或更易於存取的資訊架構。
針對產品或功能撰寫概念總覽或介紹。團隊通常會由下而上建立技術說明文件,因此有很多細節,但難以瞭解整個產品。技術撰寫人員可以修正這個問題。
針對知名用途建立教學課程。
針對特定任務建立一系列明確的使用指南。
建立貢獻者指南,其中包含有關如何開始擔任開放原始碼專案貢獻者的相關基本資訊,以及任何關於授權協議、提取要求和審查程序、建構專案等的規則。
影片是否可能用於 Google Season of Docs?
可以。請確保影片需求範圍明確,並注意製作高品質影片需要大量時間和資源。
說明文件稽核作業是否適合 Google 文件季節?
說明文件稽核是 Google 說明文件季節的絕佳專案。請留意已有多少說明文件。如有大量文件,可能需要縮減範圍 (例如只稽核教學課程內容)。如果說明文件不多或沒有任何文件,您可能會想要在專案中建立優先順序「最高」的遺漏文件。
機構和技術撰稿者是否可使用文件範本?
Google 季度文件內含 GitHub 存放區,提供可用於執行說明文件稽核作業的範本和檢查清單。我們希望在建立其他範本時加入這些範本。
Good Docs Project 致力於為開放原始碼建立一些最低可行文件範本。
機構是否必須使用技術作家製作的文件?
否。有時專案可能無法如預期運作,或需求有所變更。我們不需要機構使用產生的文件或其他資料,但我們預計最終的評估和個案研究將包含討論不使用說明文件的原因,以及專案為何決定不使用說明文件或其他素材的討論。
Google 文件季節活動會在哪裡舉辦?
「Google 文件」季節完全在線上進行。參與者不必在計畫期間出差。
如何隨時掌握 Google 文件季節的最新動態?
如要查看與 Google 季度短片季相關的最新消息和公告,請造訪 season-of-docs-announce 的公告電子郵件清單。加入這個群組,即可透過電子郵件接收最新消息。
我可以將 Google 季節性文件時間表新增至日曆嗎?
可以,你可以透過這個連結新增。
我可以透過哪些方式宣傳 Google 文件季節計畫?
你可以發推文宣傳這項計畫、撰寫網誌文章、發布影片,或是在當地舉辦聚會或資訊說明會。我們提供一些範例內容和資源,供您發送給社群 (機構、作家群組和其他聯絡人)。
如何安排或主持 Google 文件季節資訊說明會或聚會?
歡迎您在方便的時間和地點安排聚會!請詳閱計畫規則,並使用範例內容。
關於 Google 文件的 2019 和 2020 季度統計資料,您都想分享嗎?
是的,您可以前往這個頁面查看 2019 年 Google 文件季的結果,也可以前往這個頁面查看 2020 年 Google 文件季的結果。
我會收到 Google 文件季節 T 恤嗎?
否,由於國際運送限制,我們將不再為成功完成 Google 季節性文件專案的參與者提供 T 恤。
如果我有其他問題,該怎麼辦?
如果看完所有說明文件後仍未獲得解答,建議您與 Google 文件社群的討論清單討論您的問題。請參閱討論管道相關資訊,以及聯絡我們的方式。
如何成為 Google 季度文件計畫的導師?
2021 年 Google 文件季賽並沒有正式的導師角色。機構應指定技術作家的加入和支援方式,以及他們的說明文件貢獻內容如何在機構應用程式中審查及核准。如果你有興趣在 Google 文件季中擔任技術文件撰寫輔導員,建議你與貴機構的管理員合作,提供志願服務。
Google 文件季節是否像 Google Summer of Code 一樣?
否。Google 季節性文件計畫適用於具備一定技術寫作經驗的人士,並非像 Google 程式設計夏令營那樣的指導計畫。
技術文件撰寫人員專用
技術文件撰寫人員何時可以申請 Google 文件季?
2021 年 Google 文件季賽並未提供正式的技術作家申請表。如要以技術作家身分參與 2021 年 Google 季節性文件計畫,請直接聯絡開放原始碼組織,並按照「季節性文件計畫」計畫頁面上的指示操作。你也可以將自己加入 Season of Docs Technical Writer Directory,表達你的興趣。詳情請參閱技術作家指南。
如要參與 Google 文件季,我應該瞭解哪些文件工具和架構?
您要使用的文件工具和架構取決於您想與哪個機構合作。Google 文件季的目標之一,就是讓開放原始碼專案協助技術作家進一步瞭解開放原始碼產品說明文件的工具和架構。因此,在開始 Google 文件季專案之前,您不一定要具備特定文件平台的詳細知識。
不過,大多數開放原始碼組織都會在說明文件中使用某種 Markdown 或其他標記語言。建議您找出所選機構使用的語言,並熟悉語法。Markdown 是個不錯的起點,因為 GitHub README 檔案會使用 Markdown 的某種變化版本。請參閱 GitHub 的 Markdown 指南。
找出所選機構是否已在網站上代管文件,如果是的話,請確認他們使用的是哪個平台。該平台可能是 Jekyll、Sphinx 或 Hugo 等靜態網站產生器,而機構也可在閱讀文件或 GitHub 頁面上代管文件。找出貴機構使用的平台後,請探索並嘗試使用相關語言和架構。這有助您快速開始使用開放原始碼專案,並為所選開放原始碼專案提供可靠的建議。
如要參與 Google 文件季節專案,我需要熟悉哪些程式設計語言?
視說明文件專案的性質而定,您可能需要熟悉程式設計語言。選擇及提議文件專案時,請留意這一點,並向開放原始碼機構洽詢所需的熟悉程度。
技術作家是否可以繼續參與 Google 文件季的開放原始碼專案?
可以,但機構應在提案中註明技術作家與專案的先前或持續關係。
參與資格規定為何?
我是否需要具備技術文件撰寫經驗或相關訓練?
具備技術寫作經驗或接受過相關訓練尤佳,但並非必要條件。向機構提交意願書時,您可以說明自己在技術寫作方面的經驗和/或訓練。您應能提供一些證據,證明您有興趣瞭解技術說明文件或開放原始碼說明文件,包括您編寫的文件範例。開放原始碼組織會尋找具備所需經驗水準的技術作家,確保順利完成 Google 說明文件季專案。
參與 Google 文件季節是否會獲得報酬?
可以。Google 會提供補助金給獲準使用的機構,讓他們能僱用技術文件撰寫人員。
優秀的技術作家應如何表達自己的興趣?
最佳的興趣聲明來自技術作家,他們會花時間與所選開放原始碼組織互動,並在提交聲明前討論自己的想法。請參閱指南,瞭解如何建立興趣陳述式。
參與 Google 文件季節需要多久時間?
專案規模各異,但在計畫期間,每週需投入 5 到 30 小時不等的時間。不過,您花費的時間長短取決於您與機構達成的專案性質。在提交前,請先評估專案,並與開放原始碼組織討論預估時間。
我可以以個人身分提交機構申請,為開放原始碼專案建立文件嗎?我想建立一系列的網誌文章、影片或其他素材,說明如何使用開放原始碼專案或工具,但我並非該專案的參與者或貢獻者。
否,您應只有在可代表開放原始碼專案接受資金時,才能提交提案。我們鼓勵您與該專案聯絡 共同參與申請提案
我是學生,是否符合 2021 年 Google 文件季節的參賽資格?Google 文件的季節會教我成為技術文件撰稿者嗎?
學生可以與獲准的機構合作,但 Google 文件季並非旨在教授技術寫作技能。我們希望參與的技術作家具備專業的技術寫作技能,或具備等同的相關經驗。有意參與的學生,請務必在與有興趣的機構和專案聯絡時,強調自己相關的寫作和編輯經驗。
我可以同時擔任 Google Season of Docs 的技術文件撰稿者,以及 Google Summer of Code (Google Summer of Code) 的學生嗎?
雖然這目前並未違反規則,但我們強烈建議已獲 Google 夏季程式設計競賽錄取的學生,不要申請成為 Google 文件季節的技術作家。學生應專注於 Google 夏季程式設計工作,而非申請 Google 文件季節。
此外,Google 文件季節並非針對初學者而設計,而是針對具備扎實技術寫作技能和經驗的人士。「Google 文件」季中的技術文件撰寫人員並未接受指導,您需要自行整理並激勵自己制定處理機構專案的計畫,盡量減少機構管理員和其他社群成員的指導。
我是技術文件作者,如有其他疑問或疑慮,該如何與 Google Season of Docs Google 計劃管理員聯絡?
如要與 Google 季節性文件 Google 計畫管理員聯絡,請傳送電子郵件至 season-of-docs@google.com。
技術寫作公司或顧問公司可以參與「文件季」嗎?
可以,機構可以僱用公司處理提案中提及的工作。
如何在履歷中提及 Season of Docs?
請按照其他自由接案工作的方式列出這項經驗,例如「擔任『季節性文件』計畫的 [專案名稱] 技術作家」。
你是否會為參與「Google 文件季」的學員提供結業證書?
我們無法向技術作家發出證書或參與專案的確認信。
適用於開放原始碼機構管理員
開放原始碼機構的資格規定為何?
如要以機構身分參與計畫,您必須是執行積極免費/開放原始碼軟體專案的團隊,例如 BRL-CAD。專案不必是合法註冊實體。機構必須已經根據開放原始碼計畫核准的授權製作及發布軟體,且至少有兩位協作者擔任整個 Google 文件季度計畫的機構管理員,才能參與這項計畫。
請參閱計畫規則中所述的資格條件,以及美國財政部提供的制裁計畫和國家資訊。
「組織」是否等同於開放原始碼專案?
一個機構可能擁有一或多個開源專案。有些機構 (例如基金會) 可能會有多個子機構,每個子機構都有一或多個開放原始碼專案。如果貴機構有獨立的子機構,請為每個子機構分別提交申請和提案。
一個機構是否可以提交多個提案申請?
不可以。每個機構只能提交一份申請。如果貴機構有子機構 (例如貴機構是擁有許多個別開源專案的基金會),則每個專案都應提交自己的申請表,即使補助金將由總公司處理也一樣。
一組開放原始碼專案是否可以共同提交提案,以便共同進行單一說明文件專案?
一個機構應提交提案申請,並負責協調其他參與專案的工作和支援。(舉例來說,如果一組小型開放原始碼專案都是大型專案的擴充功能,而他們希望共同編寫擴充功能的操作說明,就應選擇一個機構來領導專案)。
我的機構如何收到款項?
機構必須擁有 Open Collective 帳戶,才能收取款項。
機構參與 Google 季節性文件計畫會獲得任何金錢嗎?
機構可以將行政管理、指導或審查作品的費用納入專案預算。
我的機構應如何編列技術作家的預算?
建議您參考 Write the Docs 薪資調查,並計算時薪。您也可以加入 Write The Docs Slack,並在 #season-of-docs 頻道中詢問有意參與的技術作家是否願意投標。
我的機構可以使用 Google 季節性文件計畫補助金支付現有貢獻者的費用嗎?
可以。不過,專案提案必須是針對新工作 (包括維護工作、修訂或升級現有文件)。您不得申請用來支付已完成工作的費用。
我的機構可以與學生技術寫作者合作嗎?
您可以選擇讓學生技術寫作者參與專案。如果您選擇與學生合作,強烈建議您只讓符合以下條件的學生參與:
- 年滿 18 歲
- 就讀技術寫作或技術通訊課程
- 可透過他們的計畫或課程取得技術文件指導的示範
我的機構是否可以與多位技術作家合作?
貴機構可以選取並支付多位技術作家,但與貴機構合作的所有技術作家都必須參與您提出的專案。與多位技術作家合作會使專案變得更加複雜,並需要更多志工和管理時間。
我的機構可以聘請技術寫作公司來進行專案嗎?
是的,貴機構可能會聘請技術文件撰寫公司來完成專案。請確定你僱用的公司能夠透過 Open Collective 收取款項,
我們的技術文件撰寫專員在計畫結束前就退出了。我們是否仍可領取剩餘的資金?
我們強烈建議您在計畫結束前,嘗試尋找新的技術作家來完成專案。不過,剩餘款項的撥款並非以專案完成為準,而是以完成個案研究和最終評估為準。
如果無法完成專案,我們預期個案研究會說明原因。舉例來說,您可能發現說明文件工具相當複雜,因此無法順利引進技術作家;或者,您的專案涉及測試和更新教學課程,且需要豐富的程式設計經驗。根據您的經驗,您會向其他專案推薦哪些內容?請在個案研究中加入這項資訊。
能否在提交期限前審查機構申請?
很抱歉,我們無法就貴機構的申請流程提供意見回饋。
機構應如何設定專案提案的範圍?
在構思專案構想時,請嘗試找出能為機構帶來價值的最小專案 (但如果時間允許,可以增加)。越小越好。建立專案提案時,建議您選擇較小且較詳細的專案,而非較大且較不具體的專案。如果專案需要大量領域專家,請盡量納入可由沒有該領域背景的人處理的專案。
我可以以機構管理員身分參與 Google 季節性文件計畫,並以指導老師身分參與 Google 程式設計夏令營嗎?
可以。Google 文件季和 Google 程式設計夏令營是兩項不同的計畫。如果你有能力同時參與這兩項計畫,那麼沒問題。
我們的機構曾參加過先前的 Google 季節性文件計畫。我們是否可以再次申請?
是的,參加過舊版 Google 文件計畫的機構,都有資格再次申請。
封存的資料
如何將我的資訊從 Google Season of Google 文件封存檔中移除?
如要刪除您的資訊,請與我們聯絡。