This project hopes to collect common questions and answers into peer reviewed and easily digestable form.
Collect FAQ proposals into the /proposals dir as minimal markdown files collecting links to relevant discussion, issues, comments.
All contributions should be merged quickly.
Draft content by taking interesting or high-impact questions from /proposals and writing a first draft answer and moving into /drafts. This can be derived by copy-pasting from existing discussion or synthesizing into a new form.
Some review may happen to these PRs, but they should be merged promptly.
Review and edit drafts by technical writers or native speakers and move to /published.
Peer review should be done before merging, though edits and improvements are welcome.
Build Gatsby site which exposes published FAQs as google-crawlable pages along with a top level page showing all/featured FAQ and a search bar. Use algolia or similar to search across all FAQ.
This repository is managed by EasyCLA. Project participants must sign the free (GraphQL Specification Membership agreement before making a contribution. You only need to do this one time, and it can be signed by individual contributors or their employers.
To initiate the signature process please open a PR against this repo. The EasyCLA bot will block the merge if we still need a membership agreement from you.
You can find detailed information here. If you have issues, please email operations@graphql.org.
If your company benefits from GraphQL and you would like to provide essential financial support for the systems and people that power our community, please also consider membership in the GraphQL Foundation.