Google Season of Docs 2020 參與者：Carolyn Stransky

Carolyn Stransky 是一位前端開發人員兼記者，現居德國柏林。她獲選為 Google Season of Docs 2020 - GraphQL 基金會，並在 Ivan Goncharov 的指導下進行指導。在本文中，她將分享她如何計畫在接下來幾個月為 GraphQL 基金會做出貢獻。

三年前，我第一次聽到 GraphQL 時，我認為它是一種用於建立圖表或繪製圖形上點的程式語言。在我使用 GraphQL 建立第一個應用程式後，我會將它歸類為 React 專用工具，例如 Redux 或 React Router。幾個月後，我仍然確信這只不過是另一種由 Twitter 推動的程式設計趨勢。

現在回顧過去，很明顯我最初對 GraphQL 的看法是錯誤的… 但這並不罕見。

學習一項新技術會產生許多問題，而 GraphQL 也不例外。對於 GraphQL 是什麼以及如何使用它，存在許多誤解。而且，我並不是唯一一個抱持這些不正確信念的 GraphQL 新手。

在對 GraphQL 真正 的本質有了深入的了解後，我開始在各個會議上發表關於我發現學習過程有多麼困難的演講（演講標題就是 人生很難，學習 GraphQL 也一樣）。這場演講對我來說和對我演講的聽眾來說都是一種宣洩。透過我的研究，我也了解到，儘管 graphql.org 全面涵蓋了核心概念，但它並未直接回答身為新學習者會遇到的某些問題。

幸運的是，GraphQL 已經發展到足以讓資訊公開且可取得。這比較像是找到資訊的問題，因為這些資訊分散在各種資源和程式設計社群中。這就是為什麼我很興奮看到 常見問題 (FAQ) 頁面成為 Docs 專案季提出的專案之一。而且，身為公開批評 GraphQL 文件的人，我想積極參與改善文件。

這個 FAQ 頁面背後有兩個主要目標

1. 為所有人建立一個集中式資源。到目前為止，由於與 Relay 和 React 的早期關聯，GraphQL 生態系統很大一部分都專注於 JavaScript。但 GraphQL 適用於所有人，不論程式設計語言為何，所以這個資源也應該如此。為了確保這一點，FAQ 內容將與架構無關且與供應商無關。
2. 成為真正的社群資源。GraphQL 最初是由 Facebook 傳承下來，但不再僅由 Facebook 維護。這應成為每個人都歡迎貢獻的資源，而社群也應有權力進行變更和成長。這樣一來，常見問題就不會沒有解答。

接下來兩個半月，我們將會擬定並演進如何處理此頁面的具體計畫。不過，我希望牢記這些目標，將有助於建立新的資源，協助新手和資深 GraphQL 使用者茁壯成長。

為了準備 Season of Docs 的文件開發部分，我透過分類問題和檢閱開放的 pull request，熟悉了 graphql.org 背後的儲存庫。我也協助進行 持續進行的 Gatsby 移轉，因為我將在 Gatsby 中建置新的常見問題解答頁面（如果您想貢獻，仍有 開放問題）。您可以在 我的部落格中閱讀有關社群連結階段的更多詳細資訊。

下一步是建立常見問題解答內容的初始批次。這將包含約 10-15 個問題，這些問題來自網際網路的各個領域，並諮詢過知名的 GraphQL 教師。一旦這些問題有了詳盡的解答並建置到新的 Gatsby 網站中，我將從社群（也就是您）取得回饋，並持續迭代內容、設計、版面 - 所有內容！

如果您有意見或想追蹤專案進度，請 開啟問題 或 潛伏在網站儲存庫中。

– Carolyn Stransky，GSoD 2020，Graphql Foundation