This working group is a subcommittee of the GraphQL Working Group with the following primary purpose:
To build a specification that covers many of the shared concerns when building a larger GraphQL schema as a composite of many smaller GraphQL schemas.
The resulting work-in-progress "GraphQL Composite Schemas Specification" can be found in at graphql/composite-schemas-spec.
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 at 1500 UTC on the 2nd Thursday of the month. 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).
To create the agenda files for a given month YYYY/MM, run the following command:
yarn && yarn gen-agenda YYYY MM
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.