現在のフェーズ:
プロジェクトの最終調整。タイムラインをご覧ください。
全般
Google Season of Docs は採用プログラムですか?
いいえ。Google で働くことに興味をお持ちの場合は、Google の求人ウェブサイトをご覧ください。
Google Season of Docs に参加したいのですが、どこから始めればよいかわかりません
プロジェクトのアイデアの一覧をご覧ください。
技術文書作成コミュニティに問い合わせることもできます(Write the Docs Slack の #season-of-docs
チャンネルまたはソーシャル メディア チャンネルで、サポートや提案を依頼してください)。
組織が提案できるプロジェクトの種類
以下のヒントをご覧ください。
技術ライターとオープンソース組織によって決定されるプラットフォームにドキュメント サイトを構築し、最初の一連の基本ドキュメントをサイトに公開します。プラットフォームの例:
- ドキュメントを読む
- 静的サイト生成ツール(Hugo、Jekyll、Sphinx など)
- GitHub Pages
オープンソース プロジェクトの既存のドキュメントをリファクタリングして、ユーザー エクスペリエンスの向上や情報アーキテクチャのアクセス性の向上を図ります。
プロダクトや機能のコンセプトの概要や紹介を記述します。多くの場合、チームは技術ドキュメントを下から上に向かって作成します。その結果、詳細は豊富ですが、プロダクト全体を把握するのは困難です。技術ライターが修正できます。
注目度の高いユースケースのチュートリアルを作成します。
特定のタスクに焦点を当てた一連の入門ガイドを作成します。
オープンソース プロジェクトへのコントリビューターとして参加する方法に関する基本情報、ライセンス契約に関するルール、pull リクエストとレビューのプロセス、プロジェクトのビルド方法などを含むコントリビューター ガイドを作成します。
動画は Google Season of Docs のプロジェクトに適していますか?
はい。動画の要件が適切に設定されていることを確認します。また、高品質の動画の制作には、かなりの時間とリソースが必要になることに注意してください。
ドキュメント監査は Google Season of Docs の適切なプロジェクトですか?
ドキュメントの監査は、Google Season of Docs に最適なプロジェクトです。すでに作成されているドキュメントの量に注意してください。ドキュメントが多い場合は、スコープを縮小する必要があります(チュートリアル コンテンツのみを監査するなど)。ドキュメントがほとんどまたはまったくない場合は、優先度の高い不足しているドキュメントの作成をプロジェクトに含めることをおすすめします。
組織や技術ライターが使用できるドキュメント テンプレートはありますか?
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 のタイムラインをカレンダーに追加できますか?
http://goo.gle/2NeZVew を使用して、Google Season of Docs カレンダーを定期購入します。
Google Season of Docs を広めるためにできることはありますか?
プログラムについてツイートしたり、ブログ投稿を書いたり、動画を公開したり、地域でミートアップや情報セッションを開催したりできます。コミュニティ(組織、ライター グループ、その他の連絡先)に配布できるコンテンツとリソースのサンプルがあります。
Google Season of Docs の情報セッションやミートアップを開催するにはどうすればよいですか?
ご都合のよい日時と場所でミーティングをスケジュールできます。プログラム ルールを確認し、サンプル コンテンツを使用します。
2019 年と 2020 年のプログラムに関する統計情報はありますか?
はい。2019 年の Google Season of Docs の結果は、Google オープンソース ブログ(2019、2020)で確認できます。
Google Season of Docs の T シャツはもらえますか?
いいえ。国際配送の制限により、Google Season of Docs プロジェクトを完了した参加者に T シャツを提供できなくなりました。
他にも質問がある場合はどうすればよいですか?
組織管理者ガイドと技術ライター ガイドをご覧ください。
すべてのドキュメントを確認しても解決しない場合は、ディスカッション リストで Google Season of Docs コミュニティに質問することを検討してください。ディスカッション チャネルとGoogle へのお問い合わせ方法をご覧ください。
Google Season of Docs のメンタローになるにはどうすればよいですか?
Google Season of Docs には正式なメンター役割はありません。組織は、技術ライターのオンボーディングとサポートの方法、および組織の申請の一環としてドキュメントの貢献が審査および承認される方法を指定する必要があります。Google Season of Docs の一環としてテクニカル ライターのメンタリングに興味をお持ちの場合は、組織の管理者に連絡してボランティア登録してください。
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 Season of Docs に参加するには、Google Season of Docs プログラム ページの手順に沿って、オープンソース 組織に直接お問い合わせください。 Google Season of Docs テクニカル ライター ディレクトリに登録して、関心を表明することもできます。詳しくは、技術ライター ガイドをご覧ください。
Google Season of Docs に参加するには、どのようなドキュメント作成ツールとフレームワークを知っておく必要がありますか?
使用するドキュメント ツールとフレームワークは、関心のある組織によって異なります。Google Season of Docs の目標の一部は、オープンソース プロジェクトが技術ライターに、オープンソース プロダクトのドキュメント作成に関連するツールとフレームワークについて学ぶ機会を提供することです。そのため、通常、Google Season of Docs プロジェクトを開始する前に、特定のドキュメント プラットフォームに関する詳細な知識を持っている必要はありません。
ただし、ほとんどのオープンソース組織は、ドキュメントに何らかの Markdown または別のマークアップ言語を使用しています。選択した組織で使用されている言語を確認し、構文に慣れることをおすすめします。GitHub の README ファイルは Markdown の一種を使用しているため、Markdown を使用することをおすすめします。GitHub の Markdown ガイドをご覧ください。
選択した組織がすでにドキュメントをウェブサイトにホストしているかどうか、ホストしている場合はどのプラットフォームを使用しているかを確認します。プラットフォームは、Jekyll、Sphinx、Hugo などの静的サイト生成ツールである場合もあれば、組織が 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 時間です。ただし、費やす時間は、組織と合意したプロジェクトの性質によって異なります。コミットする前に、プロジェクトを評価し、オープンソース組織と所要時間について話し合う必要があります。
個人としてオープンソース プロジェクトのドキュメントを作成するために、組織の申請を送信することはできますか?オープンソース プロジェクトやツールの使用方法に関する一連のブログ投稿、動画、その他の資料を作成したいのですが、そのプロジェクトのメンバーでも、コントリビューターでもありません。
いいえ。提案書を送信できるのは、オープンソース プロジェクトに代わって資金を受け取ることができる場合のみです。プロジェクトの一員として参加する場合は、プロジェクトに連絡して、申請提案書の作成を協力して行ってください。
私は学生ですが、Google Season of Docs に参加できますか?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 Season of Docs の技術ライターはメンタリングを受けません。代わりに、組織の管理者や他のコミュニティ メンバーからのガイダンスを最小限に抑えながら、組織のプロジェクトに取り組むための計画を自発的に立てて、モチベーションを維持する必要があります。
技術ライターとして、Google Season of Docs の Google プログラム管理者に質問や懸念事項がある場合は、どのように連絡すればよいですか?
Google Season of Docs Google プログラム管理者には、season-of-docs@google.com までメールでお問い合わせください。
技術文書作成会社やコンサルタントは Google Season of Docs に参加できますか?
はい。組織は提案書に記載されている作業を行うために会社を雇用できます。
Google Season of Docs を履歴書に記載するにはどうすればよいですか?
他のフリーランスの業務と同様に記載します。「Google Season of Docs プログラムの一環として、[プロジェクト名] のテクニカル ライターとして働いた」など。
Google Season of Docs に参加した証明書はもらえますか?
Google Season of Docs は、技術ライターにプロジェクトへの参加証明書や確認書を送信できません。
オープンソース組織の管理者向け
オープンソース組織の資格要件は何ですか?
組織として参加するには、BRL-CAD などのアクティブなフリー ソフトウェアまたはオープンソース ソフトウェア プロジェクトを運営しているグループである必要があります。プロジェクトが法的に法人化されている必要はありません。組織がプログラムに参加するには、Open Source Initiative が承認したライセンスに基づいてソフトウェアを作成してリリースし、Google Season of Docs プログラム全体の組織管理者として機能するコントリビューターを 2 人以上抱えている必要があります。すでに
プログラム ルールと米国財務省の制裁プログラムと国の情報に記載されている資格要件も参照してください。
「組織」はオープンソース プロジェクトと同じですか?
組織には 1 つ以上のオープンソース プロジェクトが存在する場合があります。財団などの組織には、それぞれ 1 つ以上のオープンソース プロジェクトを持つ複数のサブ組織が存在する場合があります。組織に独立したサブ組織がある場合は、サブ組織ごとに個別の申請と提案書を提出してください。
1 つの組織が複数の提案書を提出することはできますか?
いいえ。組織ごとに 1 件のみ申請してください。組織にサブ組織がある場合(組織が多くの個別のオープンソース プロジェクトを持つ財団などの場合)、助成金が傘下組織によって処理される場合でも、各プロジェクトが独自の申請書を提出する必要があります。
オープンソース プロジェクトのグループが、1 つのドキュメント プロジェクトに取り組むために一緒に提案書を送信することはできますか?
1 つの組織が提案書を送信し、他の参加プロジェクトとの作業調整とサポートを担当する必要があります。(たとえば、プラグインの作成に関する共同のハウツー ガイドに取り組みたい大規模なプロジェクトのプラグインである小さなオープンソース プロジェクトのグループは、プロジェクトをリードする組織を 1 つ選択する必要があります)。
組織はどのように資金を受け取りますか?
資金を受け取るには、組織が Open Collective アカウントを持っている必要があります。
Google Season of Docs に参加することで、組織は報酬を受け取りますか?
組織は、プロジェクトの予算の一部として、管理、メンターシップ、作業のレビューに必要な費用を含めることができます。
お支払い処理手数料は Google が負担しますか?
お支払い手数料は、お支払い方法によって異なるため、Google が負担することはありません。ただし、Google は Open Collective のプラットフォーム料金を負担します。また、Open Collective を財務ホストとして使用する場合は、その料金も負担します。詳しくは、助成金の受け取りに関するガイドをご覧ください。
テクニカル ライターの費用を予算に組み込むにはどうすればよいですか?
Write the Docs の給与に関するアンケートを参照して、時給を算出することをおすすめします。Write The Docs Slack に参加して、#season-of-docs チャネルで、興味のある技術ライターに入札を依頼することもできます。
組織は Google Season of Docs の助成金を使用して、現在のコントリビューターに支払いを行えますか?
はい。ただし、プロジェクトの提案は、新しい作業(既存のドキュメントのメンテナンス作業、改訂、アップグレードなど)を対象とする必要があります。すでに完了した作業の支払いに使用するための助成金は申請できません。
組織は学生の技術ライターと連携できますか?
生徒のテクニカル ライターにプロジェクトに参加してもらうこともできます。生徒と連携する場合は、次の条件を満たす生徒に限定することを強くおすすめします。
- 18 歳以上である
- 技術的な文章作成または技術的なコミュニケーションのプログラムまたはコースに登録している
- プログラムまたはコースを通じて技術文書作成メンタリングを利用できることを証明できる
複数の技術ライターと連携できますか?
組織は複数の技術ライターを選択して支払うことができますが、組織で働くすべての技術ライターは、提案したプロジェクトに取り組む必要があります。複数の技術ライターと連携すると、プロジェクトの複雑さが増し、ボランティアと管理にさらに多くの時間が必要になります。
プロジェクトに取り組むために、テクニカル ライティング会社を雇用することはできますか?
はい。組織は、プロジェクトに取り組むために技術文書作成会社を雇うことができます。委託する会社が Open Collective を通じて支払いを受けられることを確認してください。
テクニカル ライターがプログラムの終了前に退出しました。残りの金額を受け取ることはできますか?
プロジェクトは、プログラムの終了前にプロジェクトを完了するために、新しい技術ライターを探すことを強くおすすめします。ただし、残りの資金の支払いは、プロジェクトの完了ではなく、事例紹介と最終評価の完了に基づいて行われます。
プロジェクトを完了できなかった場合は、その理由をケーススタディで検証する必要があります。たとえば、ドキュメント作成ツールが非常に複雑で、技術ライターのオンボーディングの障害になっていることが判明した、プロジェクトにチュートリアルのテストと更新が含まれており、豊富なコーディング経験が必要だった、などです。これまでの経験に基づいて、他のプロジェクトにおすすめすることは何ですか?その情報をケース スタディに含めます。
組織の申請は、提出期限より前に審査できますか?
恐れ入りますが、Google Season of Docs では組織の申請についてフィードバックを提供することはできません。
組織はプロジェクトの提案の範囲をどのように設定すればよいですか?
プロジェクトのアイデアを開発する際は、組織に価値をもたらす最小限のプロジェクトを見つけてください(時間に余裕があれば拡張できます)。小さいほど良いです。プロジェクトの提案書を作成する際は、詳細が不明確な大規模なプロジェクトよりも、小規模で詳細なプロジェクトに絞ることをおすすめします。プロジェクトに多くの専門知識が必要な場合は、そのバックグラウンドのないユーザーが取り組めるプロジェクトを含めるようにしてください。
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 Season of Docs アーカイブから自分の情報を削除するにはどうすればよいですか?
情報を削除するには、Google にお問い合わせください。