This working group is a subcommittee of the GraphQL Working Group with the following primary purpose:
To design and draft an "incremental delivery" enhancement to the GraphQL specification.
Anyone in the public GraphQL community may attend a meeting of this subcommittee, provided they first sign the Specification Membership Agreement or belong to an organization which has signed.
This repository holds agendas and notes for all meetings past and upcoming as well as shared RFC documents. Anyone may edit an upcoming event's agenda to attend or propose an agenda item.
All meetings occur via video conference, however participating company offices are welcome to host guests.
Meetings are typically scheduled every Monday at 7am Pacific Time. Check the agendas for the exact date and time of upcoming meetings.
Keep track of future upcoming meetings by subscribing to the Google Calendar or ical file. (maintained in UTC because time zones are hard).
This repo is used by the individuals working on the GraphQL defer/stream spec proposal and the Incremental Delivery GraphQL-over-http proposal. GitHub discussions will be used to document architectural decisions made by this group and to gather feedback and discussions on this proposal.
The easiest way to learn about the defer/stream directives is to read the RFC.
References:
- Spec PR
- graphql-js PR
- defer/stream RFC
- graphql-over-http RFC
- express-graphql PR
- Conference talk about defer/stream
- Demo repo
- fetch-multipart-graphql (client library)
- meros (client library)
To request participation in an upcoming meeting, please send a pull request by editing the relevant meeting agenda.
We're always looking for volunteers to help take notes from the meetings, the
results of which are shared in notes/. If you're interested in
taking notes, sign up for a meeting in agendas/ and indicate that
you're willing to be a note taker.
Meetings with many participants, especially over video, can easily get hard to follow or run off course. When we talk about issues we care about, it's easy to get into heated debate. In order to respect everyone's time, and arrive to worthwhile outcomes, this subcommittee follows the "Participation guidelines" in the GraphQL Working Group; a summary of which is:
- Participate
- Don't talk too much
- Volunteer to take notes
- Have an outcome in mind
- Contribute
- Choose your battles
- Champion alternatives
- Block progress as a last resort
- Be patient and persistent
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.
Commit access is granted to this repo to members of the GraphQL TSC and some regular attendees of subcommittee meetings. To request commit access, please reach out to a TSC member.