コミュニティガーデニング、2022年5月～7月

GraphQL Foundation は、主要な技術およびコミュニティイニシアチブを奨励するためにコミュニティ助成金を提供しています。助成金の一環として、申請者は自身の活動とその GraphQL コミュニティへの影響について説明するブログ記事レポートを作成することを約束します。次のレポートは、2022年8月に助成金の申請に成功したBenjie Gillam氏によって書かれたもので、彼がその年の5月、6月、7月に実施したコミュニティガーデニングについて詳述しています。

背景#

2019年に私は GraphQL ワーキンググループの会議に定期的に参加し始め、議事録の作成を手伝っていました。当時、私たちはアクションアイテムを提出してレビューするためのシステムを持っていましたが、それを利用する人はほとんどいなかったため、アイテムは簡単に紛失していました。さらに、議事録と動画は数ヶ月ごとにまとめてアップロードされていたため、参加者はその間それらを参照することができませんでした。

その後数年間、私はこれらのプロセスを改善しようと努めました。まず、アクションアイテムを自分で提出することから始めました。しばらくすると、それらを会議ごとにGitHubプロジェクトに分類し始めました。これにより、（特に古いもの）を追跡することがはるかに簡単になり、進捗状況を確認するのに役立ちました。その後、議論を必要とするアクションアイテムに迅速に焦点を当てることを可能にする新しい「レビュー準備完了」ラベルを導入しました。これにより、すべての項目を確認する（またはすべてを完全にスキップする）のではなく、議論を必要とする項目に絞って話し合うことができるようになりました。これらのプロセスはワーキンググループから非常に高く評価されていましたが、一人にとっては非常に時間のかかるものでした。時が経つにつれて、私は GraphQL にさまざまな形で貢献するようになり、これらのタスクに費やすことができる時間が減るにつれて、これらのプロセスをスムーズに実行する能力も低下していきました。

資金承認#

2022年5月、GraphQL Foundation は、これらのタスクにより多くの時間を費やすことができるようにするためのGraphQL コミュニティ助成金の私の申請を快く承認してくれました。私はコミュニティ資金で運営されているオープンソース開発者であるため、自分のオープンソースプロジェクト（Graphileスイート）と、GraphQLワーキンググループへの貢献の両方において、オープンソースの取り組みに資金を提供するためにスポンサーシップに頼っています。助成金が承認されて以来、私はコミュニティガーデナーの役割をより適切に実行できるようになりました。この財団の助成金が、GraphQL コミュニティである皆様をより良くサポートするために、どのような形で役立ったかをご紹介します。!

GraphQL メインワーキンググループは毎月開催されます。会議は Zoom で録画され、財団の YouTube チャンネルを通じて公開されています。各会議の直後には、メイン会議だけでなく、前月に開催された可能性のあるさまざまな小委員会（GraphiQL WG、GraphQL.js WG、GraphQL-over-HTTP WG、Metadata WG、Composite Schemas WG）の動画もアップロードしています。メイン会議の動画をアップロードする際には、議事録とアクションアイテムも提出し、それらを分類して、関連する担当者に確実に割り当てます。最近では、各アクションアイテムの YouTube 動画にタイムスタンプ付きのリンクを追加し始めました。これにより、議事録からの要約ではなく、元の指示を聞くことができるようになりました。これはさらに便利になると思います。!

他の貢献者のエンパワーメント#

プロセスの文書化と効率化を目指す取り組みの一環として、新しい GraphQL 小委員会が作成されるたびに使用できるテンプレートリポジトリを作成しました。これにより、すべての小委員会は、委員長の最小限の労力で GraphQL 会議の慣行を採用することができます。リポジトリのセットアップ時に約5分かかる小さな編集リストと、もちろん定期的なスケジュール設定のみです。

また、Linux Foundation と協力して、小委員会の会議をGraphQL カレンダーにスケジュールし、EasyCLAを新しいリポジトリに拡張して、貢献するすべての人がGraphQL メンバーシップ契約に署名していることを確認しています。これにより、知的財産に関する手続きが最初から完了するため、今後の仕様バージョンや小委員会からの成果物のリリースがはるかに簡単になるはずです。

新しい資金のおかげで、GitHub の Issue、PR、ディスカッション、およびGraphQL Discord サーバーでの活動も活発化させることができました。これにより、貢献に関心のある人々に支援を提供したり、これらの環境をモデレートしたりすることができます。これには、チャンピオンになる方法を説明すること、Discord サーバーがスパムに苦しんでいる場合にタイムリーなモデレーションアクションを実行すること、および PR を改善する方法に関するガイダンスを提供することが含まれます。

課外活動#

厳密には助成金の対象ではありませんが、上記のタスクに費やす時間を GraphQL 助成金によって賄われたことで、GraphQL の他の重要な問題により多くの時間を費やすことができるようになりました。たとえば、GraphQL-over-HTTP プロジェクトを最近復活させ、その仕様の v1 に向けて順調に進んでいます。また、GraphQL Composite Schemas ワーキンググループの立ち上げも支援しました。これは、GraphQL スキーマを他の GraphQL スキーマと組み合わせて構築するさまざまな方法すべてに共通する問題に対する共有ソリューションをコミュニティが共同で作成するためのものです。また、「GraphQL メタデータ」のトピックを前進させるという私の意図を実行することもついにできました。これには、既存のソリューションとその問題に関する調査、消化、GraphQL Conference での分析の共有、独自のソリューションの提案が含まれます。また、この時間へのプレッシャーの軽減によって可能になったことの 1 つに、新しい SpecNews ポッドキャストがあります。このポッドキャストでは、共同ホストの Jem と私が、最新の GraphQL 仕様ワーキンググループセッションをわずか5〜10分でまとめています。

参加する!#

GraphQL への貢献に関心があり、開始するにあたってサポートが必要な場合は、Discordで私 (@benjie) に連絡するか、GitHub の Issue または PR を通じてご連絡ください。できる限りサポートさせていただきます。!