GraphQL 專案

本頁詳細說明 Google 文件季度接受的一項技術撰寫專案詳細資料。

專案摘要

開放原始碼組織：

GraphQL

技術撰稿人：

carolstran

專案名稱：

建立常見問題資源

專案長度：

標準長度 (3 個月)

Project description

學習新科技並非易事，而且這會產生許多問題。使用 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

最終常見問題頁面除了提供簡單明瞭的實用內容外，還要考量使用者體驗和無障礙設計。