https://github.com/graphql/wg-template
A template for GraphQL subcommittees
https://github.com/graphql/wg-template
Last synced: 11 months ago
JSON representation
A template for GraphQL subcommittees
- Host: GitHub
- URL: https://github.com/graphql/wg-template
- Owner: graphql
- Created: 2022-06-03T08:56:20.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2025-04-15T10:10:53.000Z (about 1 year ago)
- Last Synced: 2025-04-15T11:25:33.959Z (about 1 year ago)
- Language: JavaScript
- Size: 14.6 KB
- Stars: 1
- Watchers: 13
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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](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](https://github.com/graphql/graphql-wg) 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](https://github.com/graphql/graphql-wg/tree/main/membership)
or belong to an organization which has signed.
This repository holds [agendas](./agendas) and [notes](./notes) for all meetings
past and upcoming as well as [shared RFC documents](./rfcs). 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](./agendas) for the exact date and time of upcoming meetings.
Keep track of future upcoming meetings by subscribing to the
[Google Calendar](https://calendar.google.com/calendar?cid=bGludXhmb3VuZGF0aW9uLm9yZ19pazc5dDl1dWoycDMyaTNyMjAzZGd2NW1vOEBncm91cC5jYWxlbmRhci5nb29nbGUuY29t)
or
[ical file](https://calendar.google.com/calendar/ical/linuxfoundation.org_ik79t9uuj2p32i3r203dgv5mo8%40group.calendar.google.com/public/basic.ics).
(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](./agendas).
### 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/`](./notes). If you're interested in
taking notes, sign up for a meeting in [`agendas/`](./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](https://github.com/graphql/graphql-wg/blob/main/README.md#participation-guidelines);
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](https://preview-spec-membership.graphql.org)
before making a contribution. You only need to do this one time, and it can be
signed by
[individual contributors](http://individual-spec-membership.graphql.org/) or
their [employers](http://corporate-spec-membership.graphql.org/).
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](https://github.com/graphql/graphql-wg/tree/main/membership).
If you have issues, please email
[operations@graphql.org](mailto:operations@graphql.org).
### Commit access
Commit access is granted to this repo to members of the
[GraphQL TSC](./GraphQL-TSC.md) 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
```