よくある質問(FAQ)

現在のフェーズ:
ドキュメントの作成。タイムラインをご覧ください。

全般

Google シーズン オブ ドキュメントは採用プログラムですか?

いいえ。Google で働くことに関心をお持ちの場合は、Google 人材募集のウェブサイトをご覧ください。

現在のプログラムは、Google ドキュメント 2019 年および 2020 年の Google シーズンとどう違うのですか?

現在の Google シーズン オブ ドキュメント プログラムには、前年と比べて次のような大きな変更があります。

  • テクニカル ライターは、Google を通じて組織とのマッチングを申し込むことはできなくなりました。
  • 組織は、申請の一環として、予算や提案された指標などのプロジェクト提案を提出します。
  • 承認された組織は資金援助を受け取り、テクニカル ライターに支払うために使用する
  • 組織が最終評価とケーススタディを提出

Google シーズン ドキュメントで今回の変更が行われたのはなぜですか?

Google の使命は、世界中の情報を整理し、世界中の人々がアクセスして使えるようにすることです。Google では、ドキュメントの Google シーズンを振り返り、オープンソースにおける効果的なドキュメント プラクティスについて学ぶことに重点を置くことで、長期的に大きな効果を発揮したいと考えています。

私たちの組織は Google シーズン ドキュメントに参加したいと思っていますが、何から始めればよいかわかりません。

プロジェクトのアイデアの一覧をご覧ください。 テクニカル ライティング コミュニティに相談することもできます(Write the Docs Slack の #season-of-docs チャンネル、またはソーシャル メディア チャンネルを試して、ヘルプや提案を依頼します)。

組織は、どのようなタイプのプロジェクトを提案できますか?

以下のヒントをご覧ください。

  • テクニカル ライターおよびオープンソース組織が決定するプラットフォーム上にドキュメント サイトを構築し、基本的なドキュメントの初期セットをサイトで公開します。プラットフォームの例:

  • オープンソース プロジェクトの既存のドキュメントをリファクタリングして、ユーザー エクスペリエンスを向上させ、情報アーキテクチャを利用しやすくします。

  • プロダクトや機能のコンセプトの概要や紹介を記述します。多くの場合、チームは技術ドキュメントをボトムアップして作成するため、詳細は多くなりますが、プロダクト全体を理解するのは困難です。テクニカル ライターが修正できます。

  • 注目度の高いユースケースのチュートリアルを作成する。

  • 特定のタスクに重点を置いた一連の入門ガイドを作成します。

  • オープンソース プロジェクトのコントリビューターとしての基本情報や、ライセンス契約、pull リクエストとレビューのプロセス、プロジェクトの構築に関するルールなどが記載されたコントリビューター ガイドを作成します。

動画は Google シーズン ドキュメントのプロジェクトとして検討できますか?

はい。動画の要件を明確化し、高品質の動画を制作するには多大な時間とリソースが必要になることに留意してください。

ドキュメント監査は Google シーズンのドキュメントとして妥当なプロジェクトですか?

ドキュメントの監査は、Google シーズン ドキュメントに適したプロジェクトです。すでに所有しているドキュメントの数に注意してください。大量のドキュメントがある場合は、スコープを縮小する必要があります(チュートリアル コンテンツを監査するなど)。ドキュメントがほとんどまたはまったくない場合は、優先度が最も高いドキュメントの作成をプロジェクトに含めることをおすすめします。

組織やテクニカル ライターが使用できるドキュメント テンプレートはありますか?

Google シーズンの Google ドキュメントには、ドキュメント監査を実施するためのテンプレートとチェックリストが付属した GitHub リポジトリがあります。他のテンプレートが作成され次第、追加していく予定です。

Good ドキュメント プロジェクトでは、オープンソース向けに実用最小限のドキュメント テンプレートの作成に取り組んでいます。

組織は、テクニカル ライターが作成したドキュメントを使用する必要がありますか?

いいえ。ときどき、プロジェクトが期待どおりに進まなかったり、要件が変更されたりすることがあります。作成されたドキュメントやその他の資料の使用は組織に対して必須ではありませんが、最終的な評価とケーススタディでは、ドキュメントが使用されなかった理由と、ドキュメントやその他の資料を使用しないとプロジェクトがどのように決定したのかについての説明が含まれることが求められます。

Google シーズン オブ ドキュメントはどこで開催されますか?

Google ドキュメント シーズンは完全にオンラインで行われます。プログラムの一環として出張する必要はありません。

Google ドキュメント シーズンの最新情報を入手するにはどうすればよいですか?

Google シーズン ドキュメントに関する最新情報とお知らせについては、season-of-docs-announce のお知らせ用メーリング リストをご覧ください。最新情報をメールで受け取るには、グループに参加してください。

Google シーズンの Google ドキュメント タイムラインをカレンダーに追加できますか?

はい。こちらのリンクから追加できます。

Google シーズン ドキュメントについての情報を広めるにはどうすればよいですか?

プログラムに関するツイート、ブログ投稿、動画の公開、お住まいの地域でイベントや情報セッションを開催できます。コミュニティ(組織、ライター グループ、その他の連絡先)への配信に使用できるサンプル コンテンツとリソースが用意されています。

「Google シーズン ドキュメント」の情報セッションや交流会を企画、開催するにはどうすればよいですか。

イベントを開催するには、都合の良い時間と場所を選んでください。プログラム ルールを確認し、サンプル コンテンツをご利用ください。

2019 年と 2020 年のドキュメントのシーズンについて、共有できる統計情報はありますか?

はい。2019 年の Google シーズン ドキュメントの結果はこちらから、2020 年のプログラムの結果はこちらから確認できます。

Google シーズン オブ ドキュメント T シャツはもらえますか?

いいえ。国外への配送の制約により、Google シーズン ドキュメントを完了した参加者には T シャツを進呈できなくなります。

他にも質問がある場合はどうすればよいですか?

組織管理者ガイドテクニカル ライター ガイドをご覧ください。

すべてのドキュメントを読んでも答えが見つからない場合は、ディスカッション リストにある Google シーズン ドキュメント コミュニティでディスカッションしてみてください。ディスカッション チャネルに関する情報と、Google へのお問い合わせ方法をご覧ください。

Google シーズン ドキュメントでメンターになるにはどうすればよいですか?

Google シーズン Google ドキュメントは正式なメンターの役割ではありません。組織は、テクニカル ライターのオンボーディングとサポートの方法、およびテクニカル ライターの寄与したドキュメントが組織の申請の一部としてどのように審査、承認されるかを指定する必要があります。Google シーズン オブ ドキュメントでテクニカル ライターのメンタリングを行うことに関心をお持ちの場合は、組織の管理者の協力を得て、ボランティア活動を行うことをおすすめします。

Google ドキュメントのシーズンは Google Summer of Code のようなものですか?

いいえ。Google シーズンはテクニカル ライティングの経験がある方を対象としており、Google Summer of Code のようなメンタリング プログラムとして設計されたものではありません。

テクニカル ライター向け

テクニカル ライターはいつ Google シーズン ドキュメントに申し込めますか?

Google シーズン ドキュメントには、正式なテクニカル ライター用アプリケーションはありません。テクニカル ライターとして Google シーズンの Google ドキュメントに参加するには、オープンソース団体の Google シーズン ドキュメント プログラム ページの手順に沿って直接お問い合わせください。ご興味がある場合は、Google シーズンの Google ドキュメント テクニカル ライター ディレクトリにご自身を登録していただくこともできます。詳しくは、テクニカル ライター ガイドをご覧ください。

Google シーズン ドキュメントに参加するにあたって知っておくべきドキュメント ツールとフレームワークを教えてください。

使用するドキュメント ツールとフレームワークは、連携する組織によって異なります。Google シーズン ドキュメントの目的は、テクニカル ライターがオープンソース プロダクトのドキュメント作成に関連するツールやフレームワークについて詳しく学べるオープンソース プロジェクトを提供することです。そのため、Google シーズンの Google ドキュメント プロジェクトを開始する前に、特定のドキュメント プラットフォームについての詳細な知識は必要ありません。

とはいえ、ほとんどのオープンソース組織は、ドキュメントになんらかのマークダウン言語やその他のマークアップ言語を使用しています。選択した組織で使用している言語を確認し、構文に慣れることをおすすめします。GitHub README ファイルは Markdown のフレーバーを使用しているため、Markdown は優れた出発点となります。GitHub の Markdown ガイドをご覧ください。

選択した組織がウェブサイトですでにドキュメントをホストしているかどうかと、ホストしている場合はどのプラットフォームを使用しているかを確認します。プラットフォームは、JekyllSphinxHugo などの静的サイト生成ツールの場合もあれば、組織がドキュメントを読むまたは GitHub ページでドキュメントをホストする場合もあります。組織で使用しているプラットフォームがわかったら、関連する言語とフレームワークで試してみましょう。そのため、オープンソース プロジェクトをすぐに開始でき、選択したオープンソース プロジェクトに対して適切なアドバイスを提供できます。

Google シーズンの Google ドキュメント プロジェクトに参加するにあたって知っておくべきプログラミング言語はどれですか?

ドキュメント プロジェクトの性質によっては、プログラミング言語に精通している必要があります。ドキュメント プロジェクトを選択および提案するときは、この点に留意してください。また、必要な知識レベルについては、オープンソース団体にお問い合わせください。

すでにオープンソース プロジェクトに取り組んでいるテクニカル ライターは、Google シーズン Google ドキュメントの一環として、引き続きオープンソース プロジェクトに取り組むことはできますか?

はい。ただし、組織は、テクニカル ライターとプロジェクトとの関係を、提案に記録する必要があります。

参加の資格要件を教えてください。

テクニカル ライターとしての経験やトレーニングは必要ですか?

テクニカル ライティングの経験やトレーニングがあれば望ましいですが、必須ではありません。組織に関心事項を提出する場合は、自身の経験やトレーニングをテクニカル ライティングで説明できます。技術ドキュメントまたはオープンソース ドキュメントに関心があることを証明する資料(作成したドキュメントの例を含む)を提供してください。オープンソース団体は、組織が必要とする経験レベルのテクニカル ライターを募集し、Google シーズンの Google ドキュメント プロジェクトを成功に導きます。

Google シーズン ドキュメントへの参加に対する報酬は支払われますか?

はい。Google は、承認された組織にテクニカル ライターの雇用のための資金援助を提供します。

優れたテクニカル ライターの興味 / 関心の声明とはどのようなものですか?

最も関心のある記述は、記述を提出する前に、選択したオープンソース組織とアイデアを交換して話し合う時間を取るテクニカル ライターの記述です。対象となる明細書の作成に関するガイドをご覧ください。

Google シーズン ドキュメントへの参加にはどれくらいの時間がかかりますか。

プロジェクトの規模はさまざまですが、プログラムの期間中は週に 5 ~ 30 時間の作業が確約されています。ただし、かかる時間は、組織と合意したプロジェクトの性質によって異なります。commit する前に、プロジェクトを評価し、オープンソース団体と推定所要時間について話し合う必要があります。

オープンソース プロジェクトのドキュメントを作成するための、個人として組織の申請書を提出することはできますか?オープンソースのプロジェクトやツールの使い方に関するブログ投稿、動画、その他の資料を作成したいのですが、このプロジェクトには参加しておらず、貢献もしていません。

いいえ。オープンソース プロジェクトに代わって資金を受け取ることができる場合にのみ、提案を送信してください。ぜひそのプロジェクトに連絡し、申請書の作成について協力してください。

私は学生ですが、Google シーズン ドキュメントに参加する資格がありますか?Google シーズン「Google ドキュメント」ではテクニカル ライターの資格は身に付きますか?

学生は承認された組織で働く資格がありますが、Google シーズンの Google ドキュメントはテクニカルライティングのスキルを教えることを意図したものではありません。参加するテクニカル ライターには、専門的なテクニカル ライティング スキルまたは同等の経験があることが期待されます。参加を希望する学生は、関心のある組織やプロジェクトに連絡する際には、関連する執筆および編集の経験を必ず強調してください。

Google Summer of Code にテクニカル ライターとして参加し、学生として参加することはできますか?

現時点ではルール違反ではありませんが、Google Summer of Code を受講した学生は、Google シーズンの Google ドキュメントのテクニカル ライターに申し込まないことを強くおすすめします。受講者は Google シーズン ドキュメントに応募するのではなく、Google Summer of Code の課題に集中して取り組む必要があります。

また、Google シーズンの Google ドキュメントは初心者向けではなく、すでに確かなテクニカル ライティングのスキルと経験がある方を対象としています。Google シーズンの Google ドキュメントでテクニカル ライターはメンタリングされません。代わりに、組織管理者やその他のコミュニティ メンバーからの最小限のガイダンスだけで、自組織で組織のプロジェクトに取り組むための計画を策定するモチベーションが必要です。

テクニカル ライターとして、他に質問や不明点がある場合、Google シーズンの Google プログラム管理者に連絡するにはどうすればよいですか?

Google シーズンの Google のプログラム管理者へのお問い合わせは、season-of-docs@google.com 宛てにメールでお願いします。

テクニカル ライティング会社やコンサルタントは Google シーズンの Google ドキュメントに参加できますか。

はい。組織は、提案書に記載されている作業を行うために会社を雇うことができます。

履歴書で Google シーズンの Google ドキュメントについて言及するにはどうすればよいですか?

他のフリーランスの仕事と同じようにリストアップしてください(例: 「Google シーズン ドキュメント プログラムの一環として [プロジェクト名] のテクニカル ライターとして働いていました」)。

Google シーズン ドキュメントへの参加に対して修了証明書を提出できますか?

テクニカル ライターにプロジェクト参加の証明書や確認を送信することはできません。

オープンソースの組織管理者向け

オープンソース組織の資格要件は何ですか?

組織として参加するには、BRL-CAD などのフリー/オープンソース ソフトウェア プロジェクトを実行しているグループである必要があります。法的に法人化されている必要はありません。組織がこのプログラムに参加するには、オープンソース イニシアティブの承認済みライセンスでソフトウェアの制作とリリースをすでに実施し、Google シーズン オブ ドキュメント プログラム全体の組織管理者となる 2 人以上のコントリビューターがいる必要があります。

米国財務省のプログラム ルール制裁プログラムと国に関する情報に記載されている資格要件もご覧ください。

「組織」はオープンソース プロジェクトに相当しますか?

組織には 1 つ以上のオープンソース プロジェクトがあります。財団などの一部の組織には、それぞれ 1 つ以上のオープンソース プロジェクトを持つ複数の下位組織が存在する場合があります。組織に独立した下位組織がある場合は、下位組織ごとに個別の申請書と提案を提出してください。

1 つの組織で複数の提案書を提出することはできますか?

いいえ。お申し込みは 1 組織につき 1 件のみお送りください。組織に下位組織がある場合(たとえば、組織が多くの個別のオープンソース プロジェクトを持つ基盤である場合)、補助金基金が統括組織が処理する場合でも、プロジェクトごとに独自の申請を提出する必要があります。

複数のオープンソース プロジェクトのグループが 1 つのドキュメント プロジェクトに取り組む提案をまとめて提出することはできますか?

1 つの組織が提案書を提出し、他の参加プロジェクトの作業とサポートを調整する責任を負います。(たとえば、大規模なプロジェクト用のプラグインである小規模なオープンソース プロジェクトのグループで、プラグイン作成のハウツーガイドを共同で作成する場合は、プロジェクトを 1 つの組織として主導する必要があります)。

資金を受け取る方法

資金を受け取るには、組織で Open Collective アカウントを持っている必要があります。

組織は Google シーズン ドキュメントに参加するとお金を受け取ることができますか?

組織は、管理、メンターシップ、作業のレビューのための資金をプロジェクト予算の一部として含めることができます。

支払い処理手数料は Google が負担しますか?

支払い方法によって異なる場合が多いため、支払い処理手数料は Google の対象外です。ただし、Open Collective のプラットフォーム料金は Google が負担します。また、会計ホストとして Open Collective を使用する場合は、その料金もカバーされます。詳しくは、受け取り補助金ガイドをご覧ください。

テクニカル ライターの費用はどのように決めればよいですか?

Google ドキュメントの給与アンケートを作成するを確認し、時間給を算出することをおすすめします。また、Write The Docs Slack に参加し、#season-of-docs チャンネルで興味を持ったテクニカル ライターに入札を依頼することもできます。

組織で Google シーズン プログラムの助成金を使用して、現在の投稿者に支払うことはできますか?

はい。ただし、プロジェクト提案は新規作業(メンテナンス作業、改訂、既存ドキュメントのアップグレードなど)に対するものである必要があります。完了済みの課題に対する資金援助を申請することはできません。

当組織では学生のテクニカル ライターと連携できますか?

場合によっては、学生のテクニカル ライターにプロジェクトに取り組むこともできます。生徒と一緒に作業する場合は、以下に該当する生徒のみ参加させることを強くおすすめします。

  • 18 歳以上である
  • テクニカルライティングまたはテクニカルコミュニケーションの プログラムまたはコースに登録している
  • プログラムまたはコースを通じてテクニカル ライティング メンターシップを実証できる

組織で複数のテクニカル ライターと一緒に作業することはできますか?

組織は複数のテクニカル ライターを選出して支払いを行う場合がありますが、組織と連携するすべてのテクニカル ライターは、提案したプロジェクトに取り組む必要があります。複数のテクニカル ライターと連携すると、プロジェクトの複雑さが増し、ボランティアと管理にかかる時間が増加します。

組織でテクニカル ライティングの会社を雇ってプロジェクトに携わることはできますか?

はい。組織でテクニカル ライティングの会社を雇ってプロジェクトに携わることもできます。雇用する会社が Open Collective を通じて支払いを行えることを確認してください。

テクニカル ライターがプログラムの終了前に離脱してしまいました。残りの資金を受け取ることはできますか?

プログラムの終了前に、プロジェクトを完了させる新しいテクニカル ライターを見つけることを強くおすすめします。ただし、残りの資金の支払いは、プロジェクトの完了ではなく、ケーススタディと最終評価の完了に基づきます。

プロジェクトを完了できなかった場合は、ケーススタディでその理由を調査してください。たとえば、ドキュメント ツールが非常に複雑でテクニカル ライターのオンボーディングへの障壁となっている場合や、プロジェクトにチュートリアルのテストと更新が必要で、広範なコーディング経験が必要であることに気付いた場合などです。ご自身の経験に基づき、他のプロジェクトにおすすめしたいことは何ですか? その情報も事例紹介に含めます。

組織の申請を期限前に審査することはできますか?

申し訳ございませんが、組織の申請に関するフィードバックは提供いたしかねます。

組織はプロジェクト提案の範囲をどのように設定すべきですか?

プロジェクトのアイデアを練るときは、組織に価値をもたらす小規模なプロジェクトを見つけるようにします(ただし、時間があれば拡張できます)。小さいほど良いです。プロジェクト提案を作成する際は、あまり指定されていない大規模なプロジェクトよりも、小規模で詳細なプロジェクトを使用することをおすすめします。プロジェクトに多くの専門知識が必要な場合は、経験のない人でも対応できるプロジェクトを組み込んでください。

Google シーズンの Google シーズンに組織管理者として、また Google Summer of Code のメンターとして参加することはできますか?

はい。Google シーズン オブ ドキュメントと Google Summer of Code は、別のプログラムです。両方のプログラムに参加するための余裕があれば、問題ありません。

私たちの組織は、以前の「Google シーズン ドキュメント」プログラムに参加していました。再度申し込むことは可能ですか?

はい。以前の Google シーズン ドキュメント プログラムに参加したことのある組織は、再度申し込むことができます。

アーカイブされたデータ

Google シーズンの Google ドキュメントのアーカイブから情報を削除するにはどうすればよいですか?

情報を削除するには、Google にお問い合わせください。