よくある質問(FAQ)

現在のフェーズ:
2021 年の Season of Docs プログラムは 2021 年 12 月 14 日に終了しました。タイムラインをご覧ください。

全般

Google Season of Docs は採用プログラムですか?

いいえ。Google で働くことにご興味をお持ちの場合は、Google の求人ウェブサイトをご覧ください。

2021 年の Google Season of Docs の変更点

Google Season of Docs 2021 では、以下のような大幅な変更が加えられています。

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

Google Season of Docs でこの変更が行われたのはなぜですか?

Google の使命は、世界中の情報を整理し、世界中の人々がアクセス、利用できるようにすることです。Google Season of Docs の焦点を、オープンソースでの効果的なドキュメント プラクティスの学習に重点を置くことで、Google は長期的により大きな影響をもたらしたいと考えています。

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

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

組織が提案できるプロジェクトの種類

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

  • 技術ライターとオープンソース組織が決定するプラットフォームにドキュメント サイトを構築し、最初の一連の基本ドキュメントをサイトに公開します。プラットフォームの例:

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

  • プロダクトや機能のコンセプトの概要や紹介を記述します。多くの場合、チームは技術ドキュメントを下から上に向かって作成します。その結果、詳細は豊富ですが、プロダクト全体を把握するのは困難です。技術ライターが修正できます。

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

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

  • オープンソース プロジェクトへのコントリビューターとして参加する方法に関する基本情報、ライセンス契約に関するルール、pull リクエストとレビューのプロセス、プロジェクトのビルド方法などを含むコントリビューター ガイドを作成します。

「Google ドキュメントのシーズン」で動画をプロジェクトとして利用する可能性はありますか?

はい。動画の要件が適切に設定されていることを確認してください。また、高品質の動画の制作には、かなりの時間とリソースが必要になることに注意してください。

ドキュメント監査は Google Season of Docs の適切なプロジェクトですか?

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

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

Google Season of Docs には、ドキュメント監査を実施するためのテンプレートとチェックリストが記載された GitHub リポジトリがあります。他のテンプレートも作成され次第追加する予定です。

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

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

いいえ。プロジェクトが想定どおりに進まない、要件が変更されることもあります。作成したドキュメントやその他の資料を組織で使用する必要はありませんが、最終的な評価と事例紹介には、ドキュメントが使用されなかった理由と、プロジェクトでドキュメントやその他の資料を使用しないという決定が行われた理由が記載されることを想定しています。

Google Season of Docs はどこで開催されますか?

Google Season of Docs はすべてオンラインで開催されます。プログラムの一環として出張する必要はありません。

Google Season of Docs の最新情報を入手するにはどうすればよいですか?

Google Season of Docs に関する最新情報やお知らせについては、お知らせのメーリング リスト(season-of-docs-announce)をご覧ください。グループに参加して、最新情報をメールで受け取る。

「Google Season of Docs」のタイムラインをカレンダーに追加することはできますか?

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

Google Season of Docs を広めるためにできることはありますか?

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

Google Season of Docs の情報セッションやミートアップを開催するにはどうすればよいですか?

ご都合のよい日時と場所でミーティングをスケジュールできます。プログラム ルールを確認し、サンプル コンテンツを使用してください。

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

はい。2019 年の Google Season of Docs の 2019 年プログラムの結果はこちら、2020 年のプログラム結果はこちらでご覧いただけます。

Google Season of Docs の T シャツはもらえますか?

いいえ。国際配送上の制約により、「Google Season of Docs」プロジェクトを完了した参加者には T シャツを提供できなくなります。

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

組織管理者ガイドテクニカル ライターガイドを確認する。

すべてのドキュメントを確認しても回答が得られない場合は、ディスカッション リストで Google Season of Docs コミュニティに質問することをご検討ください。ディスカッション チャンネルお問い合わせ方法をご覧ください。

Google Season of Docs のメンタコーチになるにはどうすればよいですか?

2021 年の Google Season of Docs には正式なメンターの役割はありません。組織は、テクニカル ライターのオンボーディングとサポートの方法、および組織の申請の一環として、テクニカル ライターのドキュメントへの投稿をどのように審査して承認するかを指定する必要があります。Google シーズンの Google ドキュメントでテクニカル ライターのメンタリングに興味がある場合は、組織の管理者と連携してボランティア活動を行うことをおすすめします。

Google シーズンは Google Summer of Code のようなものですか?

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

テクニカル ライター向け

テクニカル ライターは Google Season of Docs にいつ応募できますか?

2021 年の Google Season of Docs には、正式な技術ライター向けの申請はありません。2021 Google Season of Docs にテクニカル ライターとして参加するには、その Season of Docs プログラム ページの手順に沿って、オープンソース組織に直接お問い合わせください。Season of Docs テクニカル ライター ディレクトリに登録して、関心を表明することもできます。詳しくは、テクニカル ライターガイドをご覧ください。

Google Season of Docs に参加するには、どのようなドキュメント作成ツールとフレームワークを知っておく必要がありますか?

使用するドキュメント ツールとフレームワークは、関心のある組織によって異なります。Google Season of Docs の目標の一つは、オープンソース プロジェクトをテクニカル ライターがオープンソース プロダクトのドキュメント化に関連するツールとフレームワークの詳細について学べるよう支援することです。そのため、通常、Google Season of Docs プロジェクトを開始する前に、特定のドキュメント プラットフォームに関する詳細な知識を持っている必要はありません。

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

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

Google Season of Docs プロジェクトに参加するには、どのようなプログラミング言語を習得する必要がありますか?

ドキュメント プロジェクトの性質によっては、プログラミング言語に精通している必要があります。ドキュメント プロジェクトを選択して提案する際は、この点を念頭に置き、必要な習熟度についてオープンソース組織にコンサルトしてください。

すでにオープンソース プロジェクトに取り組んでいる技術ライターは、Google Season of Docs の一環としてそのプロジェクトの作業を継続できますか?

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

参加資格要件は何ですか?

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

技術的な文章作成の経験やトレーニングは望ましいですが、必須ではありません。組織に興味があることを示す書類を送信する際は、技術的な文章作成に関する経験やトレーニングについて説明できます。技術ドキュメントやオープンソース ドキュメントに関心があることを示す証拠(作成したドキュメントの例など)を提示する必要があります。オープンソース団体は、Google Season of Docs プロジェクトを成功させるために、組織が必要とする経験レベルのテクニカル ライターを探します。

Google Season of Docs に参加すると報酬は支払われますか?

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

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

最も興味深いのは、意見を提出する前に、選択したオープンソース組織と時間をかけて意見を交換し、議論するテクニカル ライターによるものです。関心事項の作成に関するガイドをご覧ください。

Google Season of Docs への参加にはどのくらいの時間がかかりますか?

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

個人としてオープンソース プロジェクトのドキュメントを作成するために、組織の申請を送信することはできますか?オープンソース プロジェクトやツールの使用方法に関する一連のブログ投稿、動画、その他の資料を作成したいのですが、そのプロジェクトのメンバーでもコントリビューターでもありません。

いいえ。提案書を送信できるのは、オープンソース プロジェクトに代わって資金を受け取ることができる場合のみです。プロジェクトに連絡して、申請提案書の作成を協力して行うことをおすすめします。

私は学生ですが、2021 年の Google ドキュメントのシーズンに参加できますか?Google Season of Docs でテクニカル ライターになれますか?

学生は承認された組織と仕事をすることができますが、Google Season of Docs はテクニカル ライティング スキルの習得を目的としていません。参加する技術ライターは、専門的な技術ライティングのスキルまたは同等の関連する経験を持っていることが期待されます。参加を希望する学生は、関心のある組織やプロジェクトに連絡する際に、関連するライティングと編集の経験を強調するようにしてください。

Google Season of Docs と Google Summer of Code の両方に技術ライターと学生として参加できますか?

現在のところ、これはルール違反ではありませんが、Google Summer of Code に合格した学生は、Google Season of Docs テクニカル ライターには応募しないことを強くおすすめします。学生は、Google Season of Docs に申し込むのではなく、Google Summer of Code の作業に集中する必要があります。

また、Google Season of Docs は初心者向けではなく、すでに優れた技術文書作成スキルと経験をお持ちの方を対象としています。Season of Docs のテクニカル ライターはメンタリングを受けません。代わりに、組織の管理者や他のコミュニティ メンバーからのガイダンスを最小限に抑えながら、組織のプロジェクトに取り組むための計画を自発的に立ててモチベーションを維持する必要があります。

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

Google Season of Docs Google プログラム管理者には、season-of-docs@google.com までメールでお問い合わせください。

技術文書作成会社やコンサルタントは Season of Docs に参加できますか?

はい。組織は提案書に記載されている作業を実施するために企業を雇用できます。

履歴書に Season of Docs を記載するにはどうすればよいですか?

他のフリーランスの仕事と同じように、リストを記載してください(例: 「Season of Docs プログラムの一環として [プロジェクト名] のテクニカル ライターとして勤務した」)。

Season of Docs への参加証明書は発行されますか?

技術ライターには、プロジェクトへの参加証明書や確認書を送信できません。

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

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

組織として参加するには、BRL-CAD などのアクティブな無料/オープンソース ソフトウェア プロジェクトを実行しているグループである必要があります。プロジェクトは合法的に法人化されている必要はありません。組織がプログラムに参加するには、オープンソース イニシアティブが承認したライセンスに基づいてソフトウェアをすでに作成してリリースしており、Google Season of Docs プログラム全体で組織管理者として機能するコントリビューターが 2 人以上いることが必要です。

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

「組織」はオープンソース プロジェクトと同じですか?

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

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

いいえ。1 つの組織につき 1 回のみ申請できます。組織にサブ組織がある場合(たとえば、組織が多くのオープンソース プロジェクトを持つ基盤である場合)、プロジェクトごとに申請書を提出する必要があります。これは、補助金が包括的組織によって処理される場合でも同じです。

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

1 つの組織が提案書を提出する必要があります。また、参加する他のプロジェクトとの作業調整とサポートを担当する必要があります。(たとえば、プラグインの作成に関する共同のハウツー ガイドの作成を希望する、大規模なプロジェクトのプラグインである小規模なオープンソース プロジェクトのグループは、プロジェクトをリードする組織を 1 つ選択する必要があります)。

組織はどのように資金を受け取りますか?

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

Google Season of Docs への参加に対して組織が金銭を受け取ることはできますか?

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

テクニカル ライターの費用を予算に組み込むにはどうすればよいですか?

Write the Docs の給与調査を参照して、時給を計算することをおすすめします。Write The Docs Slack に参加して、#season-of-docs チャンネルで、興味のある技術ライターに入札を依頼することもできます。

組織は Google Season of Docs の助成金を使用して、現在のコントリビューターに支払いを行えますか?

はい。ただし、プロジェクトの提案は、新しい作業(既存のドキュメントのメンテナンス作業、改訂、アップグレードなど)を対象とする必要があります。すでに完了した作業の支払いに使用するための助成金は申請できません。

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

生徒のテクニカル ライターにプロジェクトに参加してもらうこともできます。生徒と連携する場合は、次の条件を満たす生徒に限定することを強くおすすめします。

  • 18 歳以上である
  • 技術的な文章作成または技術的なコミュニケーションのプログラムまたはコースに登録されている
  • プログラムまたはコースを通じて技術文書作成のメンターシップを利用できることを示す

複数の技術ライターと連携できますか?

組織は複数の技術ライターを選択して支払うことができますが、組織で働くすべての技術ライターは、提案したプロジェクトに取り組む必要があります。複数のテクニカル ライターと連携すると、プロジェクトの複雑さが増し、ボランティアや管理により多くの時間が必要になります。

プロジェクトに取り組むために、テクニカル ライティング会社を雇用することはできますか?

はい。組織は、プロジェクトに取り組むために技術文書作成会社を雇うことができます。依頼した会社が Open Collective を通じて支払いを受け取れることを確認してください。

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

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

プロジェクトを完了できなかった場合は、その理由をケーススタディで検証する必要があります。たとえば、ドキュメント作成ツールが非常に複雑で、技術ライターのオンボーディングの障害になっていることが判明した、プロジェクトにチュートリアルのテストと更新が含まれており、豊富なコーディング経験が必要だった、などです。これまでの経験から、他のプロジェクトに何か提案したいと思うことは何ですか。 ケーススタディにその情報を含めます。

組織の申請は、提出期限より前に審査できますか?

恐れ入りますが、組織の申請に関するフィードバックは提供できません。

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

プロジェクトのアイデアを練る際は、組織に価値をもたらす最小のプロジェクトを探すようにしてください(時間が許せば拡張することもできます)。小さいほど良いです。プロジェクトの提案書を作成する際は、詳細が不明確な大規模なプロジェクトよりも、小規模で詳細なプロジェクトに絞ることをおすすめします。プロジェクトに多くの専門知識が必要な場合は、そのバックグラウンドのないユーザーが取り組めるプロジェクトを含めるようにしてください。

Google Season of Docs には組織管理者として、Google Summer of Code にはメンターとして参加できますか?

はい。Google Season of Docs と Google Summer of Code は別々のプログラムです。両方のプログラムに参加する余裕があれば、問題ありません。

弊社は、以前の Google Season of Docs プログラムに参加しました。再申請することは可能ですか?

はい。以前の Google Season of Docs プログラムに参加した組織は、再度申し込むことができます。

アーカイブ済みデータ

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

情報の削除をご希望の場合は、Google までご連絡ください。