GraphQL Golden Path Working Group

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

To define and document an opinionated set of practices believed to give new
users of GraphQL the greatest chance of success with the technology; and to
promote their adoption across GraphQL libraries, frameworks, clients, servers,
tooling and other software.

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 on the second Thursday of the month at 10:30am
PT. 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
operations@graphql.org.

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