よくある質問(FAQ)

現在のフェーズ:
2020 年シーズンの Google ドキュメント プログラムは、2021 年 3 月 15 日に終了しました。タイムラインをご覧ください。

全般

「ドキュメントのシーズン」は採用プログラムですか?

いいえ。Google の求人に関心をお持ちの場合は、Google の求人ウェブサイトをご覧ください。

「ドキュメントのシーズン」は、インターンシップ、仕事、その他の雇用形態に該当しますか?

いいえ。「ドキュメントのシーズン」は、テクニカル ライターが独立したテクニカル ライターとして行うアクティビティであり、賞金が支払われます。テクニカル ライターは給与の受け取りをオプトアウトすることもできます。

ドキュメントのシーズンに参加するメリット

シーズン オブ ドキュメントの目標は、オープンソースの組織とテクニカル ライターのコラボレーションを促進することです。このプログラムの内容は次のとおりです。

  • テクニカル ライターに、オープンソース プロジェクトに貢献した経験を習得し、オープンソース コードについて学ぶ機会を提供します。
  • オープンソース プロジェクトにテクニカル ライティング コミュニティに参加し、オープンソース ドキュメントを改善する機会を提供します。
  • オープンソース ドキュメントとテクニカル ライティングの認知度を高める。

オープンソース組織にとってのメリット

  • テクニカル ライターと協力して業務を遂行した経験
  • ドキュメントを改善。
  • ドキュメントのシーズン終了後も テクニカル ライターとのコラボレーションを継続できる可能性があります
  • プロジェクトの文書化プロセスの改善。
  • テクニカル ライティング コミュニティにおけるオープンソース ドキュメントの認知度の向上。

テクニカル ライターのメリット:

  • オープンソース プロジェクトに貢献した経験
  • デベロッパー向けのドキュメントやコードを扱った経験
  • 取り組みに対する評価と称賛。
  • 履歴書に記載すべき情報です。
  • ドキュメントのシーズン終了後もオープンソース プロジェクトと継続的にコラボレーションできる可能性
  • オープンソース コミュニティで、テクニカル ライターがもたらす価値に対する認知度の向上。

テクニカル ライターが取り組めるプロジェクトのタイプはどれですか。

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

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

  • オープンソース プロジェクトの既存のドキュメントをリファクタリングして、ユーザー エクスペリエンスの改善や、情報アーキテクチャのアクセシビリティを改善します。

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

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

  • 特定のタスクに特化した入門ガイドを作成します。

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

動画は「ドキュメント シーズン」のプロジェクトの候補として認められますか?

はい。プロジェクトのアイデアの公開と、テクニカル ライターが提出したプロジェクト提案の選択は、オープンソース組織が行う必要があります。その動画がオープンソース団体の要件を満たしている場合は、技術指導の動画であれば、シーズンの Google ドキュメントのプロジェクトとして提出できます。動画の要件を絞り込んだうえで、高品質な動画を制作するには時間とリソースが必要になることに留意してください。

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

いいえ。Google は、このプログラムから得られるすべてのドキュメントとコードが幸福に直面することを願っていますが、テクニカル ライターのドキュメントやコードを組織に使用する必要はありません。

「ドキュメントのシーズン」が発生する場所

すべてがオンラインで行われる。このプログラムに参加するために旅行に出かける必要はありません。

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

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

どうすれば「ドキュメントのシーズン」を広めることができますか?

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

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

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

メンターとテクニカル ライターの両方として Google ドキュメントのシーズンに参加することはできますか?

いいえ。Google は、各プロジェクトやテクニカル ライターに十分な注意を払ってもらうことを目指しており、関与された人々に不快な体験をさせかねないと考えています。メンターとしての参加とテクニカル ライターとしての参加のどちらが魅力的かを選択し、それに応じて申し込んでください。

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

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

Google ドキュメントのシーズンの T シャツは提供されますか?

オーバープロビジョニングと完了したプロジェクトのテクニカル ライターとメンターには、Google ドキュメントのシーズンの T シャツが贈られます。

T シャツはいつ届きますか?

T シャツは 2021 年初頭にお届けする見込みです。Google は、T シャツを製造するベンダーと提携し、T シャツを世界中に出荷するロジスティクスを処理しています。長期にわたるプロジェクトの結果が発表されると、すぐに Google のプログラム管理者から、T シャツのスタイルとサイズを選択するための一意のアクセスコードがメールで届きます。配送の詳細を入力しましょう。通常 T シャツの制作と発送には数週間かかります。

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

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

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

テクニカル ライター向け

テクニカル ライターがドキュメント シーズンに応募できるのはいつですか?

テクニカル ライターの応募フェーズは、2020 年 6 月 9 日から 2020 年 7 月 9 日までです。プログラムのタイムラインテクニカル ライター ガイドをご覧ください。

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

使用するドキュメント ツールとフレームワークは、作業対象の組織によって異なります。シーズン オブ ドキュメントの目標の一つは、オープンソース プロダクトのドキュメント作成に関連するツールやフレームワークについて、テクニカル ライターが理解を深められるようにするオープンソース プロジェクトです。そのため、通常、ドキュメント シーズンのプロジェクトを開始する前に、特定のドキュメント プラットフォームの詳細な知識は必要ありません。

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

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

「ドキュメント シーズン」に参加するにあたって知っておくべきプログラミング言語は何ですか?

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

複数のプロジェクト提案を提出することはできますか?

はい。ただし、テクニカル ライター 1 人につき、1 件のプロジェクト提案しか受け付けられません。アプリケーションの作成に関するガイドをご覧ください。

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

はい。ただし、提案するプロジェクトとの関係をメモしておく必要があります。

グループで 1 つのプロジェクトで作業する提案をまとめて提出することはできますか?

いいえ、1 人のプロジェクトを担当できるのは 1 人だけです。

「ドキュメント シーズン」に提案を提出する前に、メンタリング組織に直接連絡することはできますか?

はい。参加を希望するオープンソース団体に直接連絡してから、ドキュメント シーズンへの応募を申請できます。オープンソースのメンターは、プロジェクトのアイデアを改善するのに役立ちます。

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

  • 登録できるのは 18 歳以上の方のみです。
  • プログラムの期間中、居住する国で勤務できる必要があります。
  • 現在、米国による禁輸措置されていない国に居住している必要があります。詳しくは、プログラム ルールと、米国財務省の制裁プログラムと国情報をご覧ください。

資格要件の例外として対応してもらえますか?

いいえ。どんなに優秀であれ、ご興味をお持ちであっても、資格要件を満たさなければ例外を認めることはできません。例外として、Google ドキュメント シーズンへの参加を申請する他のテクニカル ライターと不公平な扱いをすることになります。

どのようなフォームを提出する必要がありますか?

承認された参加者は、適切な税務フォームを提供する必要があります。

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

テクニカル ライティングの経験やトレーニングがあれば望ましいですが、必須ではありません。プロジェクト提案書を提出する際に、自身の経験やトレーニングをテクニカル ライティングで説明できます。その際、技術ドキュメントまたはオープンソース ドキュメントに関心を持っていることを示す資料(作成したドキュメントの例を含む)を提出していただく必要があります。「Google ドキュメント シーズン」プログラムは、経験豊富なテクニカル ライターやトレーニング中のテクニカル ライターがオープンソースのメンターと連携し、それぞれがお互いから学び合うことを目的としています。オープンソース組織は、組織が必要とするレベルの経験を持つテクニカル ライターを探し、ドキュメント シーズンのプロジェクトを成功裏に完了できるようにします。

「ドキュメントのシーズン」に参加して報酬を受け取ることはできますか?

はい。Google は、このプログラムを修了したテクニカル ライターに賞金を提供します。給付金を受け取らないよう選択することもできます。詳しくは、テクニカル ライターの給付金をご覧ください。

組織が私のドキュメントやコードを使用していなくても、支払いを受けることはできますか?

はい。ただし、プロジェクトがオープンソースのメンターによる最終評価に合格していれば参加できます。オープンソース プロジェクトが、生成されたドキュメントまたはコードを使用するかどうかは、テクニカル ライターの給与の支払いには影響しません。

優れたテクニカル ライター プロポーザルとはどのようなものですか?

最も優れた提案は、ドキュメント シーズンの申請書を提出する前に、選択したオープンソース組織と対話してアイデアを交換する時間を取っているテクニカル ライターからの提案です。アプリケーションの作成に関するガイドをご覧ください。

シーズンのドキュメントの利用には、どれくらいの時間がかかりますか。

費やす時間は、メンター組織と合意したプロジェクトの種類によって異なります。時間数の要件は、さまざまな種類のプロジェクトや作業スタイルに対応するために、意図的に柔軟性があります。テクニカル ライターが費やす時間は、平均で週に 20 ~ 30 時間です。

プロジェクトの提案を提出する前に、プロジェクトを評価し、オープンソース団体と所要時間について話し合ってください。他のコミットメントのために合意した時間を費やすのが難しい場合は、より長い期間でプロジェクトを完了し、賞金と作業完了の承認を受け取ることもできます。シーズンの Google ドキュメントの申請を提出する場合は、長時間実行プロジェクトのオプションを指定します。

テクニカル コミュニケーションについて学んでいますが、実務経験はまだありません。それでも参加できますか?

はい。プロジェクト提案書を提出する際に、過去の実務経験のセクションに大学または大学の課程を入力してください。

私は F1 ビザを取得済みで、米国で学生として承認済みです。参加の承認を得るにはどうすればよいですか?

詳しくは、学校の国際生徒事務局にお問い合わせください。Google は、いかなる種類の CPT または OPT 承認もお客様に提供することはできません。

承認された参加者全員に、参加の確認メールが届きます。カスタマイズされた文字は提供していません。

「ドキュメント シーズン」では申し込みフォームの情報はどのように使用されますか?

Google プログラム管理者は、アプリケーションからの情報の一部を選択したオープンソース組織の管理者に渡します。これにより、組織はプロジェクト提案を評価できます。

プロジェクトがプログラムに参加すると、シーズンの Google ドキュメントがウェブサイトでプロジェクトの詳細を公開します。

データの使用の説明については、テクニカル ライター申請フォームのガイドをご覧ください。

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

これは現時点ではルール違反ではありませんが、Google Summer of Code への参加を承認された学生は、シーズンのテクニカル ライター枠には適用しないことを強くおすすめします。学生たちは Google ドキュメントのシーズンに応募するのではなく、Google Summer of Code の課題に集中してください。

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

Google ドキュメントのシーズンにメンターとして参加する方法について詳しくは、詳しい情報はどこで確認できますか?

ドキュメントのメンターになる方法について詳しくは、メンター向けガイドプログラム ルールをご覧ください。

メンタリング組織の資格要件は何ですか?

メンタリング組織として参加するには、BRL-CAD などの有効なフリー/オープンソース ソフトウェア プロジェクトを実行しているグループであることが必要です。プロジェクトが合法的に法人化されている必要はありません。メンタリング団体がプログラムに参加するには、オープンソース イニシアチブの承認済みライセンスの下でソフトウェアの作成とリリースをすでに進めている必要があります。また、このプログラムに参加するには、組織管理者またはメンターが 2 人以上いる必要があります。

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

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

組織は 1 つ以上のオープンソース プロジェクトを持つ場合があります。財団などの組織では、それぞれが 1 つ以上のオープンソース プロジェクトを持つ複数の下位組織を持つことがあります。組織に独立した下位組織がある場合は、その旨を申込書に明記してください。たとえば、プログラミング言語「Foo」は、言語全体のドキュメントだけでなく、その言語で使用されるプラグイン、ライブラリ、またはモジュールにも適用できます。

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

良好な状態の組織には、プログラムの終了時に承認されたテクニカル ライター 1 名につき給付金が支払われます。これは、テクニカル ライターのプロジェクトが成功したかどうかに関係なく行われます。各組織は、これらの資金を必要に応じて自由にお使いいただけます。

Google プログラム管理者は、テクニカル ライティング プロジェクトの時間枠をどのように割り当てていますか?

2020 シーズンの Google ドキュメント シーズンは、合計で最大 50 件のテクニカル ライティング プロジェクトに制限されています。

承認されるプロジェクトがあまりにも多くならないように、1 組織につき最大 2 つのプロジェクトを受け入れることを想定しています。ただし、無料選択プロセスではすべてのスロットが埋まらない場合、Google プログラム管理者は、一部の組織に追加のスロットを割り当てることがあります。

テクニカル ライティング プロジェクトを選択して送信する場合は、3 つ以上のプロジェクトを選択できます。優先度の高い順に選択項目をリストアップしてください。

テクニカル ライターとのコミュニケーションでは、Google プログラム管理者がプログラムのウェブサイトで承認済みプロジェクトのリストを公開するまで、そのプロジェクトは受理されないことを明示する必要があります。

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

申し訳ございませんが、組織の申請についてフィードバックすることはできかねます。

組織はプロジェクト アイデアの範囲をどのように決定すればよいですか?

多くのプロジェクトは、進行に伴いスコープが変更されます。メンターはプロジェクトの変更を認識し、必要に応じて範囲の変更を最小限に抑え、範囲を縮小するようにします。プロジェクトのアイデアを練るときは、組織に価値をもたらす最小のプロジェクトを探してみてください(時間があれば拡張できます)。小さいほど良い。テクニカル ライターへの提案を評価する際は、具体性の低い大規模なプロジェクトよりも、小規模で詳細な提案を優先することをおすすめします。プロジェクトに多くの専門知識が必要な場合は、そのような知識のない人でも対応できるプロジェクトを組み込んでください。

ドキュメント監査は、一連のドキュメントにとって妥当なプロジェクトですか?

ドキュメントの監査は、ドキュメント シーズンに最適なプロジェクトです。ドキュメントがどれだけあるかに注意します。大量のドキュメントがある場合は、スコープを縮小する必要が生じることがあります(チュートリアル コンテンツの監査のみを行うなど)。ドキュメントがほとんど、またはまったくない場合は、最も優先度の高いドキュメントがプロジェクトの一環として作成されることを考慮してください。

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

Good Docs Project では、オープンソース向けに実用最小限のドキュメント テンプレートを作成する作業を進めています。

組織管理者とメンターの両方として Google ドキュメントのシーズンに参加できますか?

はい。組織管理者もメンターになることができます。別途メンター フォームに入力する必要はありません。組織の申請フォームまたは代替管理者フォームに入力する際は、そのフォームで、メンターも兼ねていることを示すオプションを使用する必要があります。

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

はい。「シーズンの Google ドキュメント」と「Google Summer of Code」は、別のプログラムです。両方のプログラムに参加できる帯域幅があれば問題ありません。

組織管理者またはメンターとして、Google ドキュメントのシーズンと Google Code-in の両方に参加することはできますか?

はい。ドキュメントのシーズンと Google Code-in は別のプログラムです。両方のプログラムに参加できる帯域幅があれば問題ありません。

アーカイブ データ

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

Google にご連絡のうえ、情報の削除を依頼してください。