Google Season of Docs 2020 参加者: Carolyn Stransky

Carolyn Stransky は、ドイツのベルリンを拠点とするフロントエンド開発者兼ジャーナリストです。彼女は、Google Season of Docs 2020 の GraphQL Foundation に、Ivan Goncharov のメンターシップのもとで選出されました。この記事では、彼女が今後数ヶ月間、GraphQL Foundation にどのように貢献していくかという計画を共有します。

私が3年前に初めて GraphQL について聞いたとき、それはチャートを作成したり、グラフ上に点をプロットしたりするプログラミング言語だと思いました。GraphQL で最初のアプリケーションを構築した後、私はそれを Redux や React Router のような、React に特化したツールとして分類したでしょう。数ヶ月後、私はまだそれが単なる Twitter で話題のプログラミングトレンドだと確信していました。

今振り返ると、GraphQL に対する私の最初の認識が間違っていたのは明らかです...しかし、それは珍しいことではありませんでした。

新しいテクノロジーを学ぶときには多くの疑問が生じますが、GraphQL も例外ではありません。GraphQL が何であるか、どのように使用できるかについて、非常に多くの誤解があります。そして、私だけが同じような不正確な信念に固執している GraphQL の初心者ではありませんでした。

GraphQL が *実際に* 何であるかについて確かな理解を得た後、私は会議で、学習プロセスがいかに難しかったかについてのプレゼンテーションを始めました（文字通り、講演タイトルは 人生は辛く、GraphQL を学ぶのも辛い でした）。この講演は、私にとっても、私が発表した聴衆にとっても、心の癒しになりました。調査を通じて、graphql.org はコアコンセプトを徹底的にカバーしていますが、新しい学習者として直面するいくつかの質問に直接対処していないことにも気づきました。

幸いなことに、GraphQL は情報がそこかしこにあり、利用できるほどに進化しました。その情報はさまざまなリソースやプログラミングコミュニティに散在しているため、それを見つけることが重要です。だからこそ、私は よくある質問（FAQ）ページが Season of Docs プロジェクトの1つとして提案されているのを見て興奮しました。そして、GraphQL ドキュメントを率直に批判してきた者として、私は積極的に改善する役割を果たしたいと思いました。

この FAQ ページの背後には、2つの主な目標があります。

1. 誰にとっても一元化されたリソースを構築する。現在のところ、GraphQL エコシステムの多くは、Relay および React との初期の結びつきにより、JavaScript に焦点を当てています。しかし、GraphQL はプログラミング言語に関係なく、すべての人のためのものであるため、このリソースもそうであるべきです。これを保証するために、FAQ コンテンツはフレームワークにとらわれず、ベンダーニュートラルにします。
2. 真にコミュニティ所有のリソースになる。GraphQL は当初 Facebook から受け継がれましたが、もはや Facebook のみによって維持されているわけではありません。これは誰もが自由に貢献でき、コミュニティが変更および成長する権限を与えられていると感じられるリソースであるべきです。そうすれば、よくある質問は未解決のままになることはありません。

このページにどのように取り組むかという正確な計画は、今後2ヶ月半の間で変形および進化します。しかし、これらの目標を念頭に置くことで、新規参入者と経験豊富な GraphQL ユーザーの両方が成功するのに役立つ新しいリソースにつながることを願っています。

Season of Docs のドキュメント開発パートの準備として、私は issue をトリアージし、未解決のプルリクエストをレビューすることで、graphql.org の背後にあるリポジトリに慣れました。また、Gatsby で新しい FAQ ページを構築するため、Gatsby への進行中の移行も手伝いました（貢献したい場合は、まだ 未解決のissue があります）。コミュニティボンディングフェーズの詳細については、私のブログで読むことができます。

次のステップは、FAQ コンテンツの最初のバッチを作成することです。これは、インターネットのさまざまな場所から集められ、著名な GraphQL 教師と協議して得られた、約10〜15個の質問になります。それらが徹底的な回答とともに完了し、新しい Gatsby サイトに組み込まれたら、コミュニティ（つまりあなた）からのフィードバックを得て、コンテンツ、デザイン、レイアウトなど、すべてを繰り返し改善していきます。!

意見がある場合や、プロジェクトの進捗状況をフォローしたい場合は、issue をオープンするか、ウェブサイトリポジトリを覗いてみてください。

– Carolyn Stransky、GSoD 2020、Graphql Foundation