よくある質問(FAQ)

現在のフェーズ:
結果が発表されましたタイムライン

全般

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

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

現在のプログラムは、Google ドキュメントのシーズン(2019 年および 2020 年)とどのように異なりますか?

現在の Google ドキュメント プログラムでは、前年と比べて次のような大きな変更が行われています。

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

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

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

当組織は「ドキュメントのシーズン」に参加したいと考えていますが、何から始めればよいかわかりません。

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

組織が提案できるプロジェクトのタイプ

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

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

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

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

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

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

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

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

はい。動画の要件を幅広く設定してください。また、高画質の動画の制作には多大な時間とリソースが必要になることに留意してください。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

はい。2019 年のプログラムに関する Google のシーズンの結果は、こちらから確認できます。2020 年のプログラムの結果は、こちらから確認できます。

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

いいえ。国際配送の制約により、ドキュメント シーズンのプロジェクトを完了した参加者には T シャツを提供できなくなります。

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

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

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

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

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

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

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

テクニカル ライター向け

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

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

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

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

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

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

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

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

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

はい。ただし、テクニカル ライターが提案するプロジェクトとの過去または現在の関係をメモしておく必要があります。

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

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

テクニカル ライティングの経験やトレーニングがあれば望ましいですが、必須ではありません。組織に関心を示す文言を送信する場合は、自身の経験やトレーニングをテクニカル ライティングで説明できます。その際、技術ドキュメントまたはオープンソース ドキュメントに関心があることを示す資料(作成したドキュメントの例を含む)を提供していただく必要があります。オープンソース組織は、組織が必要とするレベルの経験を持つテクニカル ライターを探し、ドキュメント シーズンのプロジェクトを成功裏に完了させます。

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

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

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

最も興味を持たれるのは、自身が選択したオープンソース団体とやり取りし、意見について話し合う時間を取ってから提出するテクニカル ライターの記述です。関心のある明細書の作成に関するガイドをご覧ください。

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

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

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

いいえ。オープンソース プロジェクトに代わって資金を受け取ることができる場合にのみ、提案を送信してください。プロジェクトに連絡して、アプリケーションの提案について協力することをおすすめします。

私は生徒ですが、ドキュメントのシーズンに参加できますか?Google ドキュメントのシーズンを通じてテクニカル ライターの資格は身につきますか?

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

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

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

また、ドキュメント シーズンは初心者向けの内容ではなく、技術的なライティングのスキルや経験が豊富な方を対象としています。シーズンのテクニカル ライターはメンターされません。代わりに、組織管理者やその他のコミュニティ メンバーからの最小限の指示で、自主的に組織のプロジェクトに取り組む計画を策定する動機付けを行う必要があります。

テクニカル ライターが追加の質問や懸念がある場合、Google の「ドキュメント シーズン」プログラムの管理者に連絡するにはどうすればよいですか?

ドキュメントのシーズンに関する Google プログラム管理者へのお問い合わせは、season-of-docs@google.com までメールでお願いできます。

テクニカル ライティング会社やコンサルタントは Season of Docs に参加できますか?

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

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

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

「Google ドキュメント シーズン」への参加に対する修了証明書はありますか?

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

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

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

組織として参加するには、BRL-CAD などの有効なフリー/オープンソース ソフトウェア プロジェクトを実行しているグループである必要があります。合法的に法人化されている必要はありません。組織がこのプログラムに参加するには、オープンソース イニシアチブの承認済みライセンスでソフトウェアを制作およびリリース済みである必要があります。また、このプログラムに参加するには、シーズン全体を通じて組織管理者となるコントリビューターが少なくとも 2 名必要です。

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

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

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

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

いいえ。応募は 1 組織につき 1 回のみとしてください。組織に下位組織がある場合(たとえば、組織に多くの個別のオープンソース プロジェクトが存在する基盤の場合)、補助金が統括組織によって処理される場合でも、各プロジェクトごとに申請を提出する必要があります。

複数のオープンソース プロジェクトのグループは、単一のドキュメント プロジェクトにまとめた提案をまとめて提出できますか?

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

資金の受け取り方法を教えてください

資金を受け取るには、Open Collective のアカウントが必要です。

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

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

支払い手続きの手数料は Google が負担しますか?

決済処理手数料は、支払い方法によって異なる傾向があるため、Google は負担しません。ただし、Open Collective のプラットフォーム料金は Google が負担します。会計ホストとして Open Collective を使用する場合も、Google が料金の対象となります。詳しくは、受け取る権限に関するガイドをご覧ください。

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

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

組織で「ドキュメントのシーズン」の助成金を利用して、現在の投稿者に支払いを行うことはできますか?

はい。ただし、プロジェクト提案は新規の作業(メンテナンス作業、リビジョン、既存のドキュメントへのアップグレードを含む)に対するものでなければなりません。すでに完了した作業に対する資金援助を申し込むことはできません。

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

学生向けテクニカル ライターにプロジェクトで取り組むこともできます。受講者と一緒に作業する場合は、以下に該当する学生のみにご参加いただくことを強くおすすめします。

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

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

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

自分の組織でテクニカル ライティング会社を雇って、プロジェクトに取り組むことはできますか?

はい。プロジェクトの作業のためにテクニカル ライティング会社を雇うこともできます。取引先が Open Collective を通じて支払いを行えるものであることをご確認ください。

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

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

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

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

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

組織はプロジェクト提案の範囲をどのように設定すればよいですか。

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

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

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

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

はい。ドキュメントの以前のシーズン プログラムに参加したことのある組織も、再度お申し込みいただけます。

アーカイブ データ

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

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