GraphQL WG (Working Group) is a semi-regular virtual meeting of maintainers of commonly used GraphQL libraries and tools and significant contributors to the GraphQL community.
The agenda of these meetings may contain anything from technical discussions about GraphQL specification and tools to planning of upcoming GraphQL events or coordination of educational efforts.
This repository holds agendas and details for upcoming meetings as well as any meeting notes from prior meetings.
All meetings occur via a group video conference, however participating company offices are welcome to host guests.
To request participation in an upcoming meeting, please send a pull request by
editing the relevant meeting in agendas/.
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, consider a few guidelines:
These guidelines are heavily inspired by Allen Wirfs-Brock.
Being in the room when decisions are being made is exciting, but meetings with large groups of people are much more difficult to follow. Only attend if an agenda item directly concerns you and your work, and you expect to participate.
The biggest distraction with many people on a video call is interruption, and interruptions are frequent when someone is talking for too long. Only speak up if you have something important to add to the discussion and be courteous of others and avoid interruption.
The rest of the community follows along with the group's discussion by reading the meeting notes. Volunteering to take notes is a great service to that community and a great way to participate if you don't have an agenda item.
Know what you and your organization wish to accomplish from the meeting and make that clear to the group to keep discussion focused on what's valuable to your agenda item. Complex or challenging outcomes might take intermediate goals across multiple meetings.
Projects like GraphQL succeed when their leaders are active contributors more than passive participants. Follow up on your discussion with pull requests to projects, or planned events.
We're all passionate about GraphQL and it's easy to get mired with an opinion in every agenda item. There are many ways to solve a problem and you won't always agree with all of them. Express your views but don't argue about a topic that is not relevant to your goals.
Sometimes you'll disagree with someone but will find it difficult or impossible to convince them of the problems you see. Instead of spending your energy fighting, commit to developing an alternative proposal so future discussion can be about substance.
This working group is only effective when consensus can be reached, even though there may be disagreements along the way. You should avoid blocking progress if possible, otherwise you may be seen as hostile to the group. However, if you have a serious issue with a proposed agenda item outcome, you must make it clear.