Skip to content

Commit 9e93639

Browse files
committed
Restructure and expand the community section
Signed-off-by: Brian Warner <[email protected]>
1 parent 5f91b65 commit 9e93639

File tree

5 files changed

+350
-123
lines changed

5 files changed

+350
-123
lines changed
Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,86 @@
1+
---
2+
title: GraphQL for Developers
3+
layout: docs
4+
category: Community
5+
permalink: /community/developers/
6+
next: /community/project-resources/
7+
sublinks: How GraphQL is developed,Participating in development,GraphQL project governance
8+
---
9+
10+
The following resources are intended to describe how GraphQL development processes work, how to get involved, and where to get help.
11+
12+
## Essential links
13+
14+
* The [GraphQL Specification](https://spec.graphql.org)
15+
* GraphQL [reference implementations and tools](/code/)
16+
* The official [GraphQL GitHub org](https://github.com/graphql)
17+
* The official [GraphQL Slack](https://slack.graphql.org)
18+
* Instructions on how to sign the [GraphQL Specification Membership Agreement](https://github.com/graphql/graphql-wg/tree/HEAD/membership)
19+
* The [GraphQL project calendar](https://calendar.graphql.org)
20+
* Meeting replays on the [GraphQL YouTube channel](https://youtube.graphql.org)
21+
22+
## How GraphQL is developed
23+
24+
At its core, the GraphQL project is organized around the [specification](https://spec.graphql.org), with a wide variety of supporting implementations and tools.
25+
26+
GraphQL has an active and mutually beneficial relationship with its many implementations. The GraphQL specification is continuously evolving under the care of the [GraphQL Working Group](https://github.com/graphql/graphql-wg), which consists of GraphQL spec experts, contributors to public [reference implementations](/code/), and implementers. At any given time, GraphQL specification updates are a combination of anticipatory planning with documentation of patterns and behaviors that are already proven in production, sometimes at very large scale.
27+
28+
### Working groups
29+
30+
The GraphQL specification, sub-specifications, and official reference implementations are developed using the working group model. The working groups meet monthly or as-needed in order to review ideas and plan their work.
31+
32+
#### The GraphQL Working Group
33+
34+
The [GraphQL Working Group](https://github.com/graphql/graphql-wg) is the main group that plans and implements changes to the [GraphQL specification](https://spec.graphql.org). It meets actively and is the default place for discussion for topics which do not have a separate breakout working group (e.g., input unions, graphql-over-http, etc).
35+
36+
* **GitHub**: [github.com/graphql/graphql-wg](https://github.com/graphql/graphql-wg)
37+
* **Meeting frequency:** Monthly, generally the first Thursday ([calendar](https://calendar.graphql.org))
38+
* **Agenda:** [GitHub](https://github.com/graphql/graphql-wg/tree/main/agendas)
39+
* **Recordings:** [YouTube](https://www.youtube.com/playlist?list=PLP1igyLx8foH30_sDnEZnxV_8pYW3SDtb)
40+
41+
#### GraphQL.js Working Group
42+
43+
The [GraphQL.js Working Group](https://github.com/graphql/graphql-js-wg) works on one of the main reference implementations, [graphql.js](https://github.com/graphql/graphql-js).
44+
45+
* **GitHub**: [github.com/graphql/graphql-js-wg](https://github.com/graphql/graphql-wg)
46+
* **Meeting frequency:** Monthly, generally the last Wednedsay ([calendar](https://calendar.graphql.org))
47+
* **Agenda:** [GitHub](https://github.com/graphql/graphql-js-wg/tree/main/agendas)
48+
* **Recordings:** [YouTube](https://www.youtube.com/playlist?list=PLP1igyLx8foHghwopNuQM7weyP5jR147I)
49+
50+
If you would like to set up a working group around a specific topic, please join a [GraphQL Working Group meeting](https://github.com/graphql/graphql-wg) and present your idea.
51+
52+
## Participating in development
53+
54+
GraphQL is developed in the open, through [GitHub](https://github.com/graphql) and working group meetings that are open for anyone to attend (so long as they are covered under the [free membership agreement](https://github.com/graphql/graphql-wg/tree/HEAD/membership)). In addition, anybody is welcome to view the [recordings of our meetings on YouTube](https://youtube.graphql.org)
55+
56+
### First steps
57+
58+
If you want to get involved in GraphQL, add yourself to the meeting agenda for one of our [working groups or implementations](https://github.com/graphql/graphql-wg/blob/main/GraphQL-TSC.md#about-the-graphql-specification-project), sign the document if you haven't already, and show up! Or, if you prefer, just open a PR against our projects as this will also initiate the spec membership signature process.
59+
60+
We welcome your participation!
61+
62+
### Getting up to speed
63+
64+
All of our work [happens in the open](https://github.com/graphql). In addition, we record our workgroups' meetings on [YouTube](https://youtube.graphql.org). If you are interested in quickly getting up to speed on what's happening in a working group, the meeting minutes and [replays](https://youtube.graphql.org) are a great place to begin.
65+
66+
### Asking questions
67+
68+
The best place to ask a development-related question is in a working group meeting, or by opening a GitHub issue. Please note that if you have an implementation question, you may get a faster answer by [asking in one of the channels more geared toward users](/community/users/#where-to-ask-questions).
69+
70+
## GraphQL project governance
71+
72+
GraphQL was open sourced by Facebook in 2015, and became a neutrally governed project managed by the Linux Foundation in 2019. In keeping with best practices, the technical governance of the GraphQL project is separate and distinct from the financial and policy governance of the [GraphQL Foundation](/foundation/).
73+
74+
### Technical governance
75+
76+
The GraphQL project is a chartered under the [Joint Development Foundation](https://www.jointdevelopment.org/) (JDF). JDF is a part of the Linux Foundation family, and is an organization specifically dedicated to making open standards easier to manage.
77+
78+
The GraphQL specification, the GraphQL Working Group, and all other sub-working groups and implementations in the [GraphQL GitHub organization](https://github.com/graphql) are governed by the [GraphQL project charter](https://technical-charter.graphql.org).
79+
80+
The [Technical Steering Committee](https://github.com/graphql/graphql-wg/blob/main/GraphQL-TSC.md), or TSC, is established in the [technical charter](https://technical-charter.graphql.org) as the top technical decision-making body. It consists of [representatives from the GraphQL technical community](https://github.com/graphql/graphql-wg/blob/main/GraphQL-TSC.md#tsc-voting-members) and is responsible for overseeing specification and development work, and approving new releases. TSC members serve a two-year term.
81+
82+
### Financial and policy governance
83+
84+
The [GraphQL Foundation](/foundation/) provides financial support for the GraphQL project. In keeping wiht best practices, the Foundation is a separate organization, which helps to ensure that technical decisions are made upon their own merit and independent of financial contributions. The GraphQL Foundation uses the funds raised through [membership dues](/foundation/join/) to support the work of the GraphQL Project through investments in infrastructure, coordination support services, developer grants, and mentorship programs.
85+
86+
The [GraphQL Foundation](/foundation/) is supported entirely by [membership dues](/foundation/join/), from [companies](/foundation/members/) who wish to support the long-term sustainability of the GraphQL ecosystem.

src/content/community/Community-Events.md

Lines changed: 44 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -3,18 +3,55 @@ title: Upcoming Events
33
layout: docs
44
category: Community
55
permalink: /community/upcoming-events/
6-
sublinks: Upcoming Events,Meetups
6+
sublinks: Project meetings,Events,Meetups
77
---
88

9-
## Upcoming Events
9+
## Project meetings
1010

11-
### GraphQL Asia
11+
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).
1212

13-
- **Date:** February, 2021
14-
- **Location:** Online
15-
- **Link:** https://graphql.asia
13+
All GraphQL project 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 [[email protected]](mailto:[email protected]).
1614

17-
GraphQL conference organized by Hasura
15+
* **Who can join GraphQL project meetings:** Anyone who has signed the free [GraphQL Specification Membership agreement](https://github.com/graphql/graphql-wg/tree/HEAD/membership).
16+
17+
* **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.
18+
19+
*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.*
20+
21+
If you have questions about this process, please ask [[email protected]](mailto:[email protected]).
22+
23+
### GraphQL Working Group / TSC meeting
24+
25+
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.
26+
27+
The goal of the working group meeting is to discuss current work and future plans for the GraphQL specification. The Working Group meeting is also the place to coordinate between other GraphQL working groups and reference implementations.
28+
29+
To join, add yourself to an [upcoming meeting agenda](https://github.com/graphql/graphql-wg/tree/HEAD/agendas).
30+
31+
### GraphQL.js Working Group meeting
32+
33+
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).
34+
35+
To join, add yourself to an [upcoming meeting agenda](https://github.com/graphql/graphql-js-wg/tree/HEAD/agendas).
36+
37+
38+
## Events
39+
40+
*None currently scheduled*
41+
42+
<!-- Event template, copy and paste what you need. Please note that the only three required fields are the name of the event, who is organizing and hosting it, and the link to the code of conduct. Events without this information can't be posted.
43+
44+
### [Name of the event - REQUIRED]
45+
46+
* **Date(s):** [date]
47+
* **Location:** [city, state, country|Virtual|Hybrid]
48+
* **Registration:** [link to reg site, with cost]
49+
* **CFP:** [link to CFP site]
50+
* **Schedule:** [link to schedule site]
51+
* **Host:** [name of organization or company hosting the event - REQUIRED]
52+
* **Code of Conduct:** [link to code of conduct - REQUIRED]
53+
54+
-->
1855

1956
## Meetups
2057

0 commit comments

Comments
 (0)