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) 页面作为拟议的 Season of Docs 项目之一。作为公开批评 GraphQL 文档的人，我想积极参与改进它们。

这个 FAQ 页面有两个主要目标

1. 为所有人构建一个集中式资源。截至目前，GraphQL 生态系统的大部分都集中在 JavaScript 上，因为早期与 Relay 和 React 相关联。但 GraphQL 适用于所有人，无论使用哪种编程语言，因此此资源也应该如此。为了确保这一点，FAQ 内容将与框架无关，并且与供应商无关。
2. 成为一个真正由社区拥有的资源。GraphQL 最初是由 Facebook 传承下来的，但它不再仅仅由 Facebook 维护。这应该是一个每个人都欢迎贡献的资源，并且社区有权改变和发展。这样，常见问题就不会得不到解答。

关于如何处理这个页面的具体计划将在接下来的两个半月内不断变化和发展。不过，我希望牢记这些目标将带来一个新的资源，帮助 GraphQL 新手和经验丰富的用户蓬勃发展。

为了准备 Season of Docs 的文档开发部分，我熟悉了 graphql.org 背后的存储库，方法是分类问题和审查开放的拉取请求。我还帮助了 正在进行的迁移到 Gatsby，因为我将在 Gatsby 中构建新的 FAQ 页面（如果您想贡献，仍然有 开放问题）。您可以在我的博客上阅读有关社区联谊阶段的更多详细信息 我的博客。

下一步是创建首批常见问题解答内容。这将是大约 10-15 个问题，这些问题来自互联网的各个领域，并与著名的 GraphQL 教师协商。一旦这些问题有了详尽的答案并被构建到新的 Gatsby 网站中，我将从社区（也就是你）那里获得反馈，并继续迭代内容、设计、布局——所有的一切！

如果你有任何意见或想关注项目的进展，请打开一个问题或在网站仓库中闲逛。

– Carolyn Stransky，GSoD 2020，Graphql 基金会