Working Group Template

This repository contains a template for creating working groups under the GraphQL Foundation. To use this template you should:

• create a new repository from it
• remove this front-matter
• customize the text in this README
• fill out (NAME) in notes/README.md
• fill out wg.config.js with details about the WG's schedule
  • name / repoUrl - update with the name and URL of your WG
  • videoConferenceDetails: ask @Benjie to generate a new series of (recorded) Zoom meetings, then update the URL and password (do NOT change the spacing, it will break the markdown)
  • liveNotesUrl: create a blank Google document with the same title as the WG, make it publicly editable, copy instructions from the main GraphQL WG live notes
  • nth, weekday, time - when will your WG be? (e.g. 4th Thursday at 10:30am-12am would be nth: 4, weekday: "Th", time: "10:30-12:00")
• generate your first month's agenda yarn && yarn gen-agenda YYYY MM (replacing YYYY MM with the meeting's year and month, e.g. 2025 01)
• let @Benjie know the first meeting is scheduled and ask for the GraphQL Foundation calendar to be updated
• (optional) ask @Benjie or a TSC member to enable agenda auto-merge:
  • set up branch protections on main, specifically requiring EasyCLA to pass (may require a PR to be raised to trigger EasyCLA the first time?)
  • uncomment the block at the top of .github/workflows/wgutils-automerge.yml

In this README, items that need replacing are ALLCAPS and surrounded by parenthesis. We've attempted to make as much of the text as possible generic so that little customization will be needed.

---

GraphQL (NAME) Working Group

This working group is a subcommittee of the GraphQL Working Group with the following primary purpose:

(MISSION STATEMENT)

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 (DETAILS OF MEETING SCHEDULE). 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).

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.

Generating agendas

To create the agenda files for a given month YYYY/MM, run the following command:

yarn && yarn gen-agenda YYYY MM