このページには、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 の方法など)
- GraphQL の著名なインストラクターとの会話
- GraphQL 関連のプロダクト ページ
- Quora
「よくある質問」の最後のページは、簡潔で有益なコンテンツの提供に加え、UX とユーザー補助にも配慮しています。