This document outlines the work that I've done for the GraphQL Foundation during GSoD.
💓 Blog post on the GraphQL Foundation site about my project
That was the title of my project and that was exactly what I did throughout my time participating in GSoD.
🔗 Current version of the deployed FAQ resource: https://graphql.org/faq/
These were the top 25 questions out of over 150 potential questions that I scraped from various resources. These resources included online sites like StackOverflow and Reddit, issues filed in the GraphQL organization repositories, as well as speaking with prominent teachers in the GraphQL community.
Once the initial version of the page was launched, I gathered feedback from all types of GraphQL learners to see if the page was clear, useful, and what could be added to improve it in the future. In total, I've spoken with over 30 people.
There are still a few pull requests under review.
There were two main goals behind this FAQ page:
- Build a centralized resource for everyone - The FAQ content will be framework agnostic and vendor-neutral.
- Become a truly community-owned resource - This should be a resource that everyone is welcome to contribute to and the community feels empowered to change and grow.
✅ Goal 1 was accomplished by extensive research, working closely with my mentor, rigorous review of the content by the GraphQL TSC, and gathering community feedback.
✅ Goal 2 is ever-evolving, but steps were taken to ensure that people know how to contribute and share their ideas. This was done by adding and updating internal documentation:
- Created a new contributing guide
- Revamped the README
- Added new issue and pull request templates (in review)
There are still a few pull requests that are either in progress or under review. Here's an overview.
- Curated the FAQ into sections and added 15 more answers
- New accordion design for the FAQ page
- More questions added based on community feedback
I'm actively working on these and plan to finish within the next couple of weeks.