Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 11 additions & 2 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,15 @@
Thanks for your interest in contributing! GAPs are community-driven proposals
that address issues outside the core GraphQL specifications.

## GAP Number Ranges

GAPs use number ranges to categorize different types of proposals:

- **1XXX** — Community directive specifications

Other ranges may be added in the future as new categories are identified. The
TSC are responsible for creating new GAP ranges.

## Filing a GAP

1. File an issue outlining the topic for public vetting.
Expand All @@ -11,8 +20,8 @@ that address issues outside the core GraphQL specifications.
author.
3. Find a sponsor with merge rights (this may be one of the authors).
4. Once approved by the authors and sponsor, GAP editors assign the GAP a
number (not necessarily the next available number), configure `CODEOWNERS`,
and merge.
number from the appropriate range (not necessarily the next available
number), configure `CODEOWNERS`, and merge.
5. GAP numbers never change. If a proposal needs significant changes, create a
new GAP and deprecate the old one.

Expand Down
8 changes: 8 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,14 @@ includes additional navigational assistance and cross-linking:

https://gaps.graphql.org/

## GAP Numbering

GAPs use number ranges to categorize different types of proposals:

- **1XXX** — Community directive specifications

Other ranges may be added in the future as new categories are identified.

## Repository structure

Each proposal lives in its own `GAP-NNNN` folder and must include:
Expand Down