GraphQL プロジェクト

このページには、Google シーズンのドキュメントで受け入れられているテクニカル ライティング プロジェクトの詳細が記載されています。

プロジェクトの概要

オープンソースの組織:
GraphQL
テクニカル ライター:
carolstran
プロジェクト名:
よくある質問のリソースを作成する
プロジェクトの期間:
標準の期間(3 か月)

プロジェクトの説明

新しいテクノロジーの学習は決して容易ではなく、同時にたくさんの問題も伴います。GraphQL によってプロジェクトは十分に進化したことで、ほとんどの部分で情報が世に出ることができました。そうした情報は、さまざまなリソースやプログラミング コミュニティに散在しているため、見つけるだけでは不十分です。

GraphQL の学習者にとって有益な情報として、よくある質問(FAQ)セクションを取り上げます。これは現在、Graphql.org には存在せず、たびたび繰り返されたり、答えられなかった質問を生み出したりしています。

この新しい「よくある質問」セクションは、graphql.org ウェブサイトに統合され、以下に関連するセクションで構成されます。

  • GraphQL の歴史と内部資料

    • GraphQL 基盤とは
    • GraphQL が作成された時期と理由を教えてください。
    • 始めるのに最適なリソースは何ですか?
  • GraphQL の基本

    • GraphQL と REST / SQL などの違いは何ですか?
    • GraphQL の最適なユースケースは何ですか?
    • GraphQL は React デベロッパー専用ですか?
  • GraphQL の高度なコンセプト

    • GraphQL でサーバーサイド キャッシュを行うには、どうすればよいでしょうか。
    • GraphQL はオフラインでの使用をサポートしていますか?
    • GraphQL API のテスト方法
  • 仕様

    • どのようにして仕様に貢献できますか?
    • 仕様のリリースに従う最良の方法は何ですか?

今後さらに多くのセクションが追加される可能性があります。上記の質問は一例です。すべて GraphQL を学んでいる同僚や、講演の後で同僚から聞いた質問です。

よくある質問の質問は、インターネットのさまざまな領域から投稿されたうえで、並べ替えられて優先順位が付けられます。たとえば、次のような分野です。

  • StackOverflow
  • GitHub の問題(GraphQL 組織、GraphQL の方法など)
  • Twitter
  • GraphQL の著名なインストラクターとの会話
  • GraphQL 関連のプロダクト ページ
  • Quora

「よくある質問」の最後のページは、簡潔で有益なコンテンツの提供に加え、UX とユーザー補助にも配慮しています。