graphql/composite-schemas-wg

The GraphQL Composite Schemas WG (subcommittee)

GraphQL Composite Schemas Working Group

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

Joining a meeting?

To request participation in an upcoming meeting, please send a pull request by editing the relevant meeting agenda.

Want to help us keep up?

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.

Participation guidelines

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

Contributing to this repo

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 [email protected].

Commit access

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.

composite-schemas-wg's Issues

[2022-08-17] EVERYONE: please review Schema Composibility Rules

Please review #37, and see if it aligns with how you feel about composability

• assignee(s): everyone! (champion: @yaacovCR)
• source: https://github.com/graphql/composite-schemas-wg/blob/main/notes/2022/2022-08-17.md#next-steps-for-subschema-composability-rules-15m-uri

---

Note: Action Item issues are reviewed and closed during Working Group
meetings.

[2022-08-17] Split glossary into 3 files and add to rfcs folder

split existing document up into 3 parts:

• Glossary.md (generic terms)
• VendorSolutions.md (the solutions that are out there)
• TermsToAvoid.md (branded/misleading/ambiguous terms)

• assignee(s): @n1ru4l
• source: https://github.com/graphql/composite-schemas-wg/blob/main/notes/2022/2022-08-17.md#next-steps-for-subschema-composability-rules-15m-uri:~:text=To%20split%20existing,misleading/ambiguous%20terms)

---

Note: Action Item issues are reviewed and closed during Working Group
meetings.

Readme broken link

The link to "shared RFCs" returns a 404 page.

[2022-08-17] Investigate test or rules suite for composability rules

To look into defining a test or rules suite reference implementation for defining what is and what isn’t composable

• assignee(s): @yaacovCR
• source: https://github.com/graphql/composite-schemas-wg/blob/main/notes/2022/2022-08-17.md#next-steps-for-subschema-composability-rules-15m-uri:~:text=To%20look%20into%20defining%20a%20test%20or%20rules%20suite%20reference%20implementation%20for%20defining%20what%20is%20and%20what%20isn%E2%80%99t%20composable

---

Note: Action Item issues are reviewed and closed during Working Group
meetings.

[2024-04] Everyone: review existing and submit additional test-cases

[ACTION] - everyone: Please look at the rfcs/test-cases folder in the composite-schemas-spec repository (and add the ones missing)

• assignee(s): everyone (champion @michaelstaib)
• source: https://github.com/graphql/composite-schemas-wg/blob/main/notes/2024/2024-04.md

---

Note: Action Item issues are reviewed and closed during Working Group
meetings.

Agenda items needed

Hey all, there haven't been any agenda items filed for a while and poor attendance; with the recent move to 3 GraphQL Spec WGs per month and an overwhelming amount of work in other areas I've fallen behind on organising the meetings for this one. If there's something you specifically want to discuss please file an issue and we can set about organising an ad-hoc meeting for it, but failing that I'll try and get the ball rolling again early next year, and maybe shoot for quarterly meetings until we start to pick up steam.

Thanks for all your inputs thus far :)

[2024-01-11] Update the google calendar

New meeting cadence, plus primary is first meeting every month.

• assignee(s): @benjie
• source: https://github.com/graphql/composite-schemas-wg/blob/15eb18843418713f0e495296349e53bd8a02b0e5/notes/2024/2024-01.md#setup-working-process-for-spec-work-20m-michaelstaib-and-martijnwalraven

---

Note: Action Item issues are reviewed and closed during Working Group
meetings.

First meeting of the GraphQL Composite Schemas WG

Hi all; I've gone on to timeanddate.com and entered in most of the cities that are appropriate (there is a limit, so I'm afraid I've had to collapse a few that were in the same timezone, e.g. Germany and Italy don't get their own entries). The result:

https://www.timeanddate.com/worldclock/meetingtime.html?day=14&month=7&year=2022&p1=3775&p2=110&p3=24&p4=37&p5=188&p6=496&p7=676&p8=438&p9=268&p10=234&p11=78&p12=604&iv=0

From this, 1500 UTC seemed the best time all-round, so I have gone ahead and booked in our first meeting on 14th July at 1500 UTC; please add yourselves to the agenda if you can make it:

https://github.com/graphql/composite-schemas-wg/blob/main/agendas/2022/2022-07-14.md

Due to running the meeting I will not be able to take notes as I usually do, so I'd really appreciate a few of you helping out on that 👍

Interested parties: @yaacovCR @rivantsov @timsuchanek @saihaj @mcollina @Urigo @xuorig @praveenweb @hwillson @michaelstaib @ndejaco2 @grillorafael @okjulian @nathanchapman @bobbiejc @chikit @agata-wit (I will not be doing this each time, just this first time!)

September meeting aborted due to lack of participants

See you all on October 13th!

Meeting missing from Google Calendar

The meeting for the composite schema working group needs adding to the Foundation's Google calendar (linked from the agenda)

Please say if there's a way for us lurkers to do this in the future.

[2022-08-17] Add Kensho example to vendors document

Predrag to add an example in the glossary/relevant doc for the Kensho example mentioned

• assignee(s): @obi1kenobi
• source: https://github.com/graphql/composite-schemas-wg/blob/main/notes/2022/2022-08-17.md#next-steps-for-subschema-composability-rules-15m-uri:~:text=Predrag%20to%20add%20an%20example%20in%20the%20glossary/relevant%20doc%20for%20the%20Kensho%20example%20mentioned

---

Note: Action Item issues are reviewed and closed during Working Group
meetings.

[2024-02] EVERYONE: Review Section 1: Overview

Though a lot of the spec text is still in very heavy flux, a lot of effort has been put into Section 1 to ensure it captures what we're setting out to solve in this working group/specification. Please read it, and if there's anything you disagree with or feel is missing, please raise an issue!

• assignee(s): Everyone (champion @michaelstaib)
• source: https://github.com/graphql/composite-schemas-wg/blob/main/notes/2024/2024-02.md

---

Note: Action Item issues are reviewed and closed during Working Group
meetings.

[2024-01-11] Setup the weekly meetings agendas

4pm UTC every week on Thursdays.
First meeting every month is the "primary" meeting.

Copy setup script from graphql-wg repo and adjust as necessary.

• assignee(s): @benjie / @michaelstaib
• source: https://github.com/graphql/composite-schemas-wg/blob/15eb18843418713f0e495296349e53bd8a02b0e5/notes/2024/2024-01.md#setup-working-process-for-spec-work-20m-michaelstaib-and-martijnwalraven

---

Note: Action Item issues are reviewed and closed during Working Group
meetings.