Skip to content

Commit ce36221

Browse files
jemgillambenjie
andauthored
How to join a working group (#2158)
We had many people ask how to get involved in the working groups at GraphQL Conference. Many times, I was told that they had tried to join before but there were no easy steps to follow when it came to signing the required CLA. We even had questions asked about it during workshops, but because we had all filled it out a long time ago it was easy to forget that it can be a convoluted process. --------- Co-authored-by: Benjie <benjie@jemjie.com>
1 parent 9d0b7f8 commit ce36221

File tree

12 files changed

+197
-23
lines changed

12 files changed

+197
-23
lines changed

src/pages/_meta.tsx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ export default {
2424
events: { title: "Events & Meetups" },
2525
contribute: {
2626
title: "Contribute to GraphQL",
27-
href: "/community/contribute/essential-links",
27+
href: "/community/contribute/governance",
2828
},
2929
foundation: { title: "Foundation" },
3030
},
Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
export default {
2-
"essential-links": "",
3-
grant: "Community Grant Program",
4-
development: "Participating in Development",
52
governance: "GraphQL Project Governance",
63
"how-graphql-is-developed": "",
7-
"project-resources": "",
84
"project-meetings": "",
5+
development: "Participating in Development",
6+
grant: "Community Grant Program",
7+
"essential-links": "",
8+
"project-resources": "",
99
}
Lines changed: 66 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,76 @@
1+
import { Cards } from "../../../components/cards"
2+
13
# Participating in Development
24

35
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)
46

5-
## First steps
6-
7-
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.
8-
9-
We welcome your participation!
10-
117
## Getting up to speed
128

13-
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.
9+
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 (`notes` folder in the relevant repository) and [replays](https://youtube.graphql.org) are a great place to begin.
1410

1511
## Asking questions
1612

1713
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/resources/official-channels/).
14+
15+
16+
## GraphQL projects and implementations
17+
18+
<Cards
19+
items={[
20+
21+
{
22+
title: "GraphQL Specification",
23+
link: "https://github.com/graphql/graphql-spec",
24+
description: "This is a Working Draft of the Specification for GraphQL, a query language for APIs created by Facebook. The target audience for this specification is not the client developer, but those who have, or are actively interested in, building their own GraphQL implementations and tools. To join in with its development, join the main GraphQL Working Group",
25+
},
26+
{
27+
title: "GraphQL.js",
28+
link: "https://github.com/graphql/graphql-js",
29+
description: "The JavaScript reference implementation for GraphQL.",
30+
},
31+
{
32+
title: "GraphiQL IDE",
33+
link: "https://github.com/graphql/graphiql",
34+
description: "Whether you want a simple GraphiQL IDE instance for your server, or a more advanced web or desktop GraphQL IDE experience for your framework or plugin, or you want to build an IDE extension or plugin, you've come to the right place!",
35+
},
36+
{
37+
title: "GraphQL Website",
38+
link: "https://github.com/graphql/graphql.github.io",
39+
description: "The source repository for this very website: GraphQL Documentation, community initiatives and more",
40+
},
41+
{
42+
title: "GraphQL over HTTP Specification",
43+
link: "https://github.com/graphql/graphql-over-http",
44+
description: "HTTP is the most common choice as the client-server protocol when using GraphQL because of its ubiquity. However the GraphQL specification deliberately does not specify the transport layer. This specification is intended to fill this gap by specifying how GraphQL should be served over HTTP. ",
45+
},
46+
{
47+
title: "graphql-http",
48+
link: "https://github.com/graphql/graphql-http",
49+
description: "Simple, pluggable, zero-dependency, GraphQL over HTTP spec compliant server, client and audit suite.",
50+
},
51+
{
52+
title: "GraphQL Composite Schema Spec",
53+
link: "https://github.com/graphql/composite-schemas-spec",
54+
description: "Describes how to construct a single unified GraphQL schema, the composite schema, from multiple GraphQL schemas, each termed a source schema.",
55+
},
56+
{
57+
title: "GraphQL Scalars Specification",
58+
link: "https://github.com/graphql/graphql-scalars",
59+
description: "Providing a directory of GraphQL Custom Scalar specifications, contributed by the community. GraphQL Custom Scalar specifications are language agnostic and thus can be used to document and standardize behavior across different languages.",
60+
},
61+
{
62+
title: "Dataloader",
63+
link: "https://github.com/graphql/dataloader",
64+
description: "A generic utility to be used as part of your application's data fetching layer to provide a simplified and consistent API over various remote data sources such as databases or web services via batching and caching.",
65+
},
66+
{
67+
title: "SWAPI GraphQL Wrapper",
68+
link: "https://github.com/graphql/swapi-graphql",
69+
description: "A wrapper around the Star Wars API, or \"swapi\" (Swah-pee) the world's first quantified and programmatically-accessible data source for all the data from the Star Wars canon universe, converting it into a GraphQL schema.",
70+
},
71+
]}
72+
/>
73+
74+
If you want to get involved in GraphQL, add yourself to the meeting agenda for one of our [working groups or implementations](./project-meetings/#quick-guide-how-to-join), 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.
75+
76+
We welcome your participation!

src/pages/community/contribute/how-graphql-is-developed.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ import {
99

1010
At its core, the GraphQL project is organized around the [specification](https://spec.graphql.org), with a wide variety of supporting implementations and tools.
1111

12-
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.
12+
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](/community/contribute/development/#graphql-projects-and-implementations), 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.
1313

1414
## Working Groups
1515

@@ -18,7 +18,7 @@ The GraphQL specification, sub-specifications, and official reference implementa
1818
<div className="border-l-2 border-primary pl-6 md:pl-10">
1919
### The GraphQL Working Group
2020

21-
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 (breakout working groups include the [Input Union WG](https://github.com/graphql/graphql-spec/blob/main/rfcs/InputUnion.md) and the [GraphQL-over-HTTP WG](https://github.com/graphql/graphql-over-http)).
21+
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 (breakout working groups include the [Composite Schemas WG](https://github.com/graphql/composite-schemas-wg/) and the [GraphQL-over-HTTP WG](https://github.com/graphql/graphql-over-http), see [GraphQL subcommittee meetings](/community/contribute/project-meetings/#graphql-subcommittee-meetings) for more).
2222

2323
<Cards
2424
items={[
46.4 KB
Loading
32.2 KB
Loading
64.1 KB
Loading
98.4 KB
Loading
40 KB
Loading
30.2 KB
Loading

0 commit comments

Comments
 (0)