常見問題 (FAQ)

當前階段:
說明文件開發。請參閱時間表

一般

Google Seasons 是招聘計畫嗎?

不需要。如果你有意為 Google 工作,請造訪 Google 工作機會網站

目前的計畫與 2019 和 2020 年的 Google 文件季別有何不同?

目前的「Google 文件季服務」計畫與前幾年有重大變更,包括:

  • 技術撰稿人不再透過 Google 應徵,因此無法比對到機構
  • 機構會在申請過程中提交專案提案 包括預算和提議的指標
  • 已接受的組織會獲得補助,用來支付技術撰寫人員
  • 組織提交最終評估和個案研究

為什麼 Google 文件季別會進行這些變更?

Google 的使命是彙整全球資訊,供大眾使用,使人人受惠,我們希望藉由重新調整 Google 文件季度的重點,強調如何使用有效的開放原始碼文件做法,長期下來將能發揮更大的影響力。

我們的機構想參加 Google 文件季服務,但不知該從何著手!

歡迎查看完整的專案想法清單!您也可以聯絡技術寫作社群 (請嘗試使用「Write the Document Slack」(撰寫文件 Slack) 中的 #season-of-docs 頻道,或在社交媒體管道上尋求協助或提案。

機構可以提出哪些類型的專案?

不妨參考下列建議:

  • 在平台上建立說明文件網站,供技術撰寫人員及開放原始碼組織決定,然後在網站上發布一組基本文件。例如:

  • 重構開放原始碼專案的現有說明文件,以提供改善使用者體驗或更容易存取的資訊架構。

  • 撰寫產品或功能的概念總覽或簡介。一般而言,團隊通常會由下而上建立技術說明文件,結果有很多細節,但很難瞭解產品整體。技術撰寫人員能修正這個問題。

  • 建立有關重要用途的教學課程。

  • 針對特定工作建立一組聚焦式使用指南。

  • 建立貢獻者指南,內容包括如何開始成為開放原始碼專案貢獻者的基本資訊、有關授權協議、提取要求與審查程序、建構專案等的所有規則。

Google 文件季別製作可以製作的影片嗎?

是,確保影片要求的範圍適當,並請注意製作高畫質影片需要耗費大量時間和資源。

稽核 Google 文件季度文件是否是一項合理的專案稽核專案?

文件稽核作業是 Google 文件季度的重要計畫。請留意現有的文件數量;如果您的文件數量很多,可能需要縮減範圍 (例如只稽核教學課程內容)。如果您只有少部分或沒有任何說明文件,可以在專案中加入優先順序最高的缺少的說明文件。

有沒有文件範本可供組織和技術撰稿人使用?

Google Season 文件含有 GitHub 存放區,內含用於執行說明文件稽核的範本和檢查清單。我們希望在建立其他範本時加入。

The Good Document Project 目前正致力為開放原始碼建立一些最小可行的說明文件範本。

機構是否需要使用技術撰稿人製作的文件?

否。有時候專案無法如預期終止,或者要求發生變化。 我們不會要求機構使用產生的文件或其他素材,但我們預計最終評估和個案研究會包括討論為何不該使用該說明文件,以及這項專案如何決定該決定不使用文件或其他資料。

Google 季節性文件出現在哪裡?

Google 文件季完全是在線上進行。參加這項計畫不需要旅行。

如何隨時掌握 Google 文件季別的最新資訊?

請前往 season-of-docs-announce 查看公告郵寄清單,取得與 Google 文件季度相關的最新消息和公告。加入群組即可透過電子郵件接收最新消息。

我可以在日曆中加入 Google 文件季度的時間表嗎?

可以。您可以透過這個連結新增該網域。

我可以透過哪些方式宣傳 Google 文件季度?

您可以發布有關這項計畫的推文、撰寫網誌文章、發布影片,或舉辦聚會或舉辦資訊活動。我們提供一些範例內容和資源,可用於向社群 (機構、撰寫者群組和其他聯絡人) 發布內容。

如何籌備或舉辦 Google 賽季文件資訊講座或聚會?

您隨時可以視需要安排時間進行聚會!請參閱計畫規則並參考範例內容

對於 2019 和 2020 季度文件,你是否有任何統計資料可以分享?

可以。您可以在這裡查看 2019 年計畫的 Google 季度文件結果,您也可以按這裡查看 2020 年計畫的結果。

這樣可以獲得 Google 季節文件 T 恤嗎?

否,由於國際運送限制,我們無法再為成功完成 Google 文件季別專案的參與者提供 T 恤。

如有其他問題,該怎麼辦?

請參閱機構管理員指南技術撰寫人員指南

閱讀所有說明文件後,如果您還是無法找到答案,可考慮在討論清單中與 Google Season of 文件社群討論您的問題。請參閱討論管道的相關資訊,以及如何與我們聯絡

如何成為 Google 文件季度的導師?

Google 文件季別沒有正式的導師角色。機構應指定技術寫入者的加入和支援方式,以及他們在機構申請過程中如何審查及核准他們的文件貢獻。如果您想利用「Google 文件」季度來指導技術撰稿人,建議您與機構管理員合作。

Google 的季別文件會像 Google Summer of Code 一樣嗎?

不可以。Google 季度文件是專為有技術寫作經驗的人而設計,並非以 Google Summer of Code 這類指導計劃的形式設計。

技術文件撰寫人員

技術撰稿人何時可以申請參加 Google 文件季文件?

Google Season of Document 並未提供正式的技術文件撰寫應用程式。如要以技術文件作者的身分參與 Google Seasons,請依開放原始碼 Google Season of 文件計畫頁面的指示,直接與開放原始碼機構聯絡。您也可以將自己加入 Google 季節性文件技術寫入者目錄,表達您的參與意願。詳情請參閱技術撰寫人員指南

我應該瞭解哪些文件工具和架構,才能參與 Google Seasoning 文件?

您使用的說明文件工具和架構視您想合作的機構而定。Google 文件季度的部分目標之一,是協助技術撰稿人進一步瞭解開放原始碼產品的相關工具和架構。因此,您通常不需要先具備特定說明文件平台的相關知識,再著手使用 Google Season of 文件專案。

也就是說,大部分的開放原始碼機構都會在說明文件中使用 Markdown 或其他標記語言。建議您找出所選機構使用的語言,熟悉語法。Markdown 是不錯的起點,因為 GitHub README 檔案採用 Markdown 的口味。請參閱 GitHub 指南:Markdown

確認您選擇的機構是否已將說明文件託管在網站上,以及該機構使用的平台為何。該平台可能是靜態網站產生器 (例如 JekyllSphinxHugo),也可能是機構在閱讀說明文件GitHub 頁面上代管文件。找到機構使用的平台後,請探索相關語言和架構,並進行實驗。如此可幫助您快速上手開放原始碼專案,也可以集中一處為您選擇的開放原始碼專案提供音效建議。

我應該瞭解哪些程式設計語言,才能參與 Google 文件季文件專案?

視說明文件專案的性質而定,您可能需要熟悉程式設計語言。當您選擇及建議說明文件專案時,請務必留意這一點,並向開放原始碼組織諮詢所需的熟悉程度。

已經在 Google 文件季中展開開放原始碼專案的技術撰寫人員是否能繼續著手處理這類專案?

是的,但機構應記下技術撰寫人員先前或目前與提案中專案的關係。

參加計劃有哪些資格規定?

我是否需要具備相關經驗或培訓,擔任技術撰稿人?

建議您事先完成技術寫作經驗或訓練,但不強制要求。 向機構提交興趣聲明時,您可以描述自己的經驗和/或技術書面訓練。您應能提供部分證據,以證明您對技術說明文件或開放原始碼說明文件感興趣,包括您編寫的文件範例。開放原始碼機構會尋找具備機構所需經驗程度的技術撰稿人,確保他們能順利完成 Google 的「Google 文件季文件」專案。

參加「Google 文件」季報會獲得報酬嗎?

是,Google 將提供授權給獲準的機構,以便使用技術撰稿人。

怎樣才算是優秀的技術撰稿人?

最好的表達方式是來自技術撰稿人,他們花時間在提交陳述「之前」,花時間與所選的開放原始碼機構互動並討論構想。請參閱建立感興趣陳述式指南。

參與 Google Seasoning 文件需要多少時間?

專案規模各不相同,但可在計畫期間每週 5 至 30 小時。不過,您花費的時間取決於您與機構同意的專案性質。在提交之前,您應先評估專案,並與開放原始碼組織討論預估的時間。

我可以提交機構申請,以個人身分建立開放原始碼專案的說明文件嗎?我想撰寫一系列網誌文章、影片或其他素材,學習如何使用開放原始碼專案或工具,但我不是專案成員,也沒有提供協作者。

否,除非您能夠代表開放原始碼專案收款,否則請勿提交提案。我們建議您與專案聯絡,共同參與應用程式提案。

我是學生,可以參加 Google 文件季網站的活動嗎?Google 文件季別會教我擔任技術撰稿人嗎?

學生有資格與獲準的機構合作,但 Google 文件季度的不適合用來教導學生技術寫作技巧。我們期望參與的技術寫作人員具備專業的專業技術撰寫能力,或具備同等的相關經驗。想要參與的學生在聯繫感興趣的機構和專案時,請務必強調他們相關的寫作與編輯體驗。

我可以同時參與 Google 文件季文件的技術文件作者和 Google Summer of Code 的學生嗎?

雖然這目前未違反規定,但我們強烈建議接受 Google Summer of Code 的學生申請參加 Google 文件季文件技術撰稿。學生應該專心處理 Google Summer of Code 的作業,而不是應申請 Google 季度文件。

此外,Google Seasoning 文件並非適合初學者,適合對專業寫作技巧和經驗有一定程度的使用者採用。Google Season 文件技術撰寫人員並未給予指導,而是需要自行規劃和積極規劃,在對機構專案進行最低限度的規劃時,在機構管理員和其他社群成員提供最少的指導。

身為技術撰稿人,如果我有其他問題或疑慮,如何與 Google 季別文件 Google 計劃管理員聯絡?

如要與 Google Season of Document Google 計畫管理員聯絡,請傳送電子郵件至 season-of-docs@google.com

是否有技術寫作公司或顧問可以參與 Google 當季文件計畫?

是的,機構可以僱用公司完成提案中列出的工作。

如何在履歷中提及 Google 季別文件?

比照其他自由接案內容的方式列出,例如「在 Google 文件季別計畫中擔任 [專案名稱] 的技術撰稿人」。

Google 文件季度是否會提供結業證書?

我們無法將參與專案活動的證明或確認函傳送給技術撰稿人。

適用於開放原始碼的機構管理員

開放原始碼組織必須符合哪些資格規定?

如要以機構身分加入,您必須是執行有效的免費/開放原始碼軟體專案 (例如 BRL-CAD) 的群組。專案不一定要是合法的公司實體。申請機構必須已經依據開放原始碼計畫核准的授權製作及發布軟體,且至少有兩位協作者擔任整個 Google 季節性文件計畫的機構管理員,才能參與這項計畫。

另請參閱計畫規則和美國財政部的制裁計畫和國家/地區資訊中所述的資格規定。

「機構」是否等同於開放原始碼專案?

機構可能會有一或多項開放原始碼專案。某些機構 (例如基金會) 可能有多個子機構,而每個子機構都有一或多個開放原始碼專案。如果您的機構有獨立的子機構,請分別為每個子機構提交申請與提案。

公司可以提交多項提案申請表嗎?

不可以。每個機構組織只能提交一份申請表。如果貴機構有子機構 (例如貴機構是多個個別開放原始碼專案的基礎),則每個專案都應提交自己的應用程式,即使補助金會由綜合機構處理。

一組開放原始碼專案是否能同時提交提案,以便執行單一文件專案?

一個機構應提交提案申請,並負責協調其他參與專案的工作和支援。(舉例來說,假設有一個小型的開放原始碼專案,這些外掛程式全部適用於某個大型專案,並想針對建立外掛程式的使用指南,選擇一個機構來主導專案)。

我的機構會透過什麼方式收取款項?

貴機構必須擁有開放式統籌帳戶才能獲得資金。

機構參加「Google 文件季別」會獲得任何報酬嗎?

機構可在專案預算中納入管理、指導或審查工作資金。

Google 會支付付款手續費嗎?

Google 不負責支付款項處理費,因為金額可能會因付款方式而異。不過,Google 會負擔 Open Collective 平台費用,如果您決定使用 Open Collective 做為財務主機,詳情請參閱接收授予計畫指南

我的組織應該如何編列技術撰稿人的費用?

建議您參閱撰寫 Google 文件薪資問卷調查,並列出每小時費率。您也可以加入「Write The Document Slack」,然後在 #season-of-docs 頻道中請感興趣的技術撰寫者出價。

我的機構可以使用 Google 整季文件的補助授權給目前的協作者嗎?

是,不過,專案提案必須適用於新工作 (包括維護工作、修訂或現有說明文件的升級)。您可能無法申請補助來支付已完成的工作費用。

我的機構可以和學生技術撰稿人合作嗎?

您可以選擇請學生技術作家著手處理專案,如果您決定與學生合作,我們強烈建議您將課程對象限制為符合下列條件的學生:

  • 年滿 18 歲
  • 參加技術撰文/技術通訊計畫或課程
  • 具備相關專業能力,透過計畫或課程取得技術書面指導

我的機構可以與多位技術撰稿人合作嗎?

您的機構可能會選擇並支付多位技術作者,但與貴機構合作的所有技術撰稿人都必須完成您提議的專案。與多位技術寫入人員合作會讓專案變得更複雜,所需的志工和管理時間也會增加。

我的機構可以聘僱技術寫作公司來參與我們的專案嗎?

可以,貴機構可以聘僱技術寫作公司來處理您的專案。請確認您所僱的公司能透過 Open Collective 收取款項。

我們的技術文件寫手在計畫結束前就退出了。是否還能收到剩餘資金?

強烈建議您在計畫結束前,嘗試尋找新的技術撰寫人員完成專案。不過,剩餘資金並非根據專案完成情況發放,而是在完成個案研究和最終評估。

如果無法完成專案,我們預計會在個案研究中探討原因。舉例來說,您可能發現說明文件工具非常複雜,而且在培訓技術撰寫人員方面遇到困難,或者您的專案需要測試及更新教學課程,而且需要廣泛的程式設計經驗。根據您的經驗,您會向其他專案推薦什麼?請在個案研究中加入這項資訊。

機構申請可以在提交期限前接受審查嗎?

很抱歉,我們無法針對機構申請提供意見。

機構應該如何界定專案提案範圍?

構思專案構想時,請試著找出能為機構帶來價值的最小專案 (但可在時間允許的情況下展開)。越小越好建立專案提案時,建議您採用規模較小且較詳細的專案,而非較不明確的大型專案。如果專案需要大量領域的專業知識,請嘗試納入沒有該背景的人也能執行的專案。

我可以參加 Google 文件季度的組織管理員,以及擔任 Google Summer of Code 的導師嗎?

是,Google Season of Document 和 Google Summer of Code 是兩個不同的計畫。如果您有足夠的頻寬參與這兩項程式,也沒關係。

我們的機構參與了先前的 Google 文件季度計畫,是否可以再次申請?

是,已參加過 Google 文件季度文件計畫的機構可再次申請。

封存的資料

如何從 Google 文件封存內容中移除我的資訊?

如要移除您的資訊,請與我們聯絡