diff --git a/src/pages/community/contribute/_meta.ts b/src/pages/community/contribute/_meta.ts index 624a6f29d4..84a4eaba8c 100644 --- a/src/pages/community/contribute/_meta.ts +++ b/src/pages/community/contribute/_meta.ts @@ -1,9 +1,9 @@ export default { - "essential-links": "", - grant: "Community Grant Program", - development: "Participating in Development", governance: "GraphQL Project Governance", "how-graphql-is-developed": "", - "project-resources": "", "project-meetings": "", + development: "Participating in Development", + grant: "Community Grant Program", + "essential-links": "", + "project-resources": "", } diff --git a/src/pages/community/contribute/images/Screenshot 2025-09-26 at 15.50.42.png b/src/pages/community/contribute/images/Screenshot 2025-09-26 at 15.50.42.png new file mode 100644 index 0000000000..10e3cd7915 Binary files /dev/null and b/src/pages/community/contribute/images/Screenshot 2025-09-26 at 15.50.42.png differ diff --git a/src/pages/community/contribute/images/development/Step1-1.png b/src/pages/community/contribute/images/development/Step1-1.png new file mode 100644 index 0000000000..826864bcf6 Binary files /dev/null and b/src/pages/community/contribute/images/development/Step1-1.png differ diff --git a/src/pages/community/contribute/images/development/Step1-2.png b/src/pages/community/contribute/images/development/Step1-2.png new file mode 100644 index 0000000000..ce9b5b255b Binary files /dev/null and b/src/pages/community/contribute/images/development/Step1-2.png differ diff --git a/src/pages/community/contribute/images/development/Step1-4.png b/src/pages/community/contribute/images/development/Step1-4.png new file mode 100644 index 0000000000..2d0e04f037 Binary files /dev/null and b/src/pages/community/contribute/images/development/Step1-4.png differ diff --git a/src/pages/community/contribute/images/development/Step1-6.png b/src/pages/community/contribute/images/development/Step1-6.png new file mode 100644 index 0000000000..afd925d85c Binary files /dev/null and b/src/pages/community/contribute/images/development/Step1-6.png differ diff --git a/src/pages/community/contribute/images/development/Step2-1.png b/src/pages/community/contribute/images/development/Step2-1.png new file mode 100644 index 0000000000..5dc2272a65 Binary files /dev/null and b/src/pages/community/contribute/images/development/Step2-1.png differ diff --git a/src/pages/community/contribute/images/development/Step2-5.png b/src/pages/community/contribute/images/development/Step2-5.png new file mode 100644 index 0000000000..9dbd67b01d Binary files /dev/null and b/src/pages/community/contribute/images/development/Step2-5.png differ diff --git a/src/pages/community/contribute/images/development/Step3-3.png b/src/pages/community/contribute/images/development/Step3-3.png new file mode 100644 index 0000000000..21b5790bf4 Binary files /dev/null and b/src/pages/community/contribute/images/development/Step3-3.png differ diff --git a/src/pages/community/contribute/project-meetings.mdx b/src/pages/community/contribute/project-meetings.mdx index 3064dadcf2..38ce781cec 100644 --- a/src/pages/community/contribute/project-meetings.mdx +++ b/src/pages/community/contribute/project-meetings.mdx @@ -1,21 +1,36 @@ +import { Cards } from "../../../components/cards" +import { Callout } from 'nextra/components' +import { Steps } from 'nextra/components' + # Project Meetings -All GraphQL technical meetings are open to anyone who is interested, so long as they first complete the [GraphQL Specification Membership agreement](https://github.com/graphql/graphql-wg/tree/HEAD/membership). +All GraphQL technical meetings are open to anyone who is interested, so long as they first complete the [GraphQL Specification Membership agreement](https://github.com/graphql/graphql-wg/tree/HEAD/membership). Participation in the technical meetings is free. All GraphQL technical meetings should appear on the [GraphQL public calendar](https://calendar.graphql.org). If a project's meeting isn't on the calendar or is incorrect, please email operations@graphql.org. -- **Who can join GraphQL technical meetings:** Anyone who has signed the free [GraphQL Specification Membership agreement](https://github.com/graphql/graphql-wg/tree/HEAD/membership). +## Who can join GraphQL technical meetings? -- **How to join:** Each GraphQL project must maintain an agenda document for each meeting, and each attendee must add themselves to it prior to attending. To join, open a PR to add your name to the attendee list on an upcoming meeting's agenda (for example, the [GraphQL Working Group](https://github.com/graphql/graphql-wg/tree/HEAD/agendas) or [GraphQL.js](https://github.com/graphql/graphql-js-wg/tree/main/agendas)). The agenda document will have the date, time and Zoom links. +Anyone who has signed the free [GraphQL Specification Membership agreement](https://github.com/graphql/graphql-wg/tree/HEAD/membership). -import { Callout } from 'nextra/components' +## Quick guide: How to join + +1. Sign the GraphQL Specification Membership agreement (first time only) + 1. Open a pull request against the [EasyCLA repository](https://github.com/graphql/easycla) + 1. Follow the steps provided by the EasyCLA bot + 1. Choose to sign the CLA as an individual or on behalf of a corporation +1. Open a pull request against the meeting's agenda (forking if necessary) + 1. Add your name and affiliation to the agenda + 1. Add any agenda items, with a time estimate (optional) +1. Join using the provided Zoom link +1. Notes are taken by AI, and volunteers are welcome to add to a shared notes doc during the meeting +1. Meetings are recorded and later made available on the [GraphQL Foundation Working Groups YouTube channel](https://www.youtube.com/@GraphQLFoundation) + +[See below for detailed instructions](#how-to-join-a-meeting) on how to sign the membership agreement and join a meeting using a GitHub pull request. **IMPORTANT:** Your PR against the agenda **must** be merged before you can attend. If the EasyCLA bot says you are not covered, you need to follow the links in the bot's comment to sign the [GraphQL Specification Membership agreement](https://github.com/graphql/graphql-wg/tree/HEAD/membership) before you can attend. -If you have questions about this process, please ask [operations@graphql.org](mailto:operations@graphql.org). - ## GraphQL Working Group / TSC meeting The [GraphQL Working Group](https://github.com/graphql/graphql-wg) meets on the first Thursday of each month. When there are topics to address, the [GraphQL Technical Steering Committee (TSC)](https://github.com/graphql/graphql-wg/blob/HEAD/GraphQL-TSC.md) may meet briefly prior to the start of the Working Group meeting. @@ -24,8 +39,105 @@ The goal of the working group meeting is to discuss current work and future plan To join, add yourself to an [upcoming meeting agenda](https://github.com/graphql/graphql-wg/tree/HEAD/agendas). -## GraphQL.js Working Group meeting +## GraphQL subcommittee meetings + + + +## How to join a meeting + +If you have questions about this process, please ask [operations@graphql.org](mailto:operations@graphql.org). + + +### Make a pull request to the EasyCLA repository + +The GraphQL Specification Membership agreement is managed by a neutral GitHub repository where you can open a pull request and initiate the EasyCLA signing process. All pull requests will be closed periodically. You only need to do this one time, and it can be signed by individual contributors or their employers. + +You can read about the full process, including details about whether to sign as an individual or under an organization, [at the EasyCLA GitHub repository](https://github.com/graphql/graphql-wg/tree/main/membership). + +1. Begin by pressing the edit button in the top right corner of the "README" file + +![Edit button](./images/development/Step1-1.png) + +2. When prompted, create a fork of the project by pressing the green "Fork this repository" button + +![Fork button](./images/development/Step1-2.png) + +3. Make a small change to the README file, it doesn't matter what the change is as it won't be merged into the file +4. Press "Commit changes" + +![Make a commit](./images/development/Step1-4.png) + +5. Confirm your change by pressing "Propose changes", you can use the default commit message +6. This opens a comparison page where you can check your change and press "Create pull request" + +![Create pull request](./images/development/Step1-6.png) + +7. Now it's time to make your pull request. You can change the title and add to the body of the message if you like, then press "Create pull request" +8. After a minute, an automated comment will appear underneath your pull request from "linux-foundation-easycla bot" asking you to sign the EasyCLA + +### Sign the EasyCLA + +1. Press "Click here to be authorized" in the message the EasyCLA bot left on your pull request + +![Click the link to be authorized](./images/development/Step2-1.png) + +2. You'll be asked to grant the Linux Foundation bot some permissions to work with your GitHub account; press "Authorize LF-Engineering" +3. You will be redirected to the EasyCLA platform. Here, you need to choose whether to proceed as an individual or on behalf of your company. If you choose corporate, you may need to contact your company's CLA manager. You'll also be able to read the document before signing it, by pressing "Download PDF" +4. After choosing which way to proceed, the document will be generated with DocuSign, ready for you to sign electronically. When you have filled in the required fields, press "Finish" +5. You will be redirected back to your pull request, and after a few minutes the EasyCLA bot will show that you have signed the agreement + +![EasyCLA recognizes the signed CLA](./images/development/Step2-5.png) + +### Add yourself to the list of attendees + +1. Find your [chosen working group above](#graphql-working-group--tsc-meeting) and find its next agenda by browsing to agendas -> year -> month in the central pane of the GitHub webpage +2. Press the Edit button in the top right corner of the agenda file, and when prompted create a fork by pressing the "Fork this repository" button +3. The file is written in markdown and is generally easy to read. Scroll down to `## Attendees`. Add your information following the format of the other attendees in the list. You can preview your change in a rich text format by pressing "Preview" in the top left of the editing pane + +![Create pull request to the agenda](./images/development/Step3-3.png) -The [GraphQL.js working group](https://github.com/graphql/graphql-js-wg) meets the second Tuesday of each month. The goal is to plan development work and resolve issues with [GraphQL.js](https://github.com/graphql/graphql-js). +4. If applicable, add an agenda item under the `## Agenda` heading, make sure you add your item to the end of the list and add an estimated duration of discussion +5. Press "Commit changes", fill in the details of your changes in the popup, and then press "Propose changes" +6. Now you can review your changes and create your pull request to the agenda by pressing "Create pull request" +7. If you successfully signed the EasyCLA, you will pass the Easy CLA check and your pull request may be automatically merged if you pass the automatic checks. +8. If you don't pass the automatic checks, don't worry, reach out on the [community Discord](https://discord.graphql.org/) or request a [TSC member](https://github.com/graphql/graphql-wg/blob/HEAD/GraphQL-TSC.md#tsc-membership) as a reviewer of your pull request. -To join, add yourself to an [upcoming meeting agenda](https://github.com/graphql/graphql-js-wg/tree/HEAD/agendas). +