Skip to content

Commit 01c9fa6

Browse files
authored
Update contributing guidelines for Code page (graphql#980)
* Updating contributing guidelines for Code page * Fix mistakes oops
1 parent 687d3cd commit 01c9fa6

File tree

1 file changed

+22
-3
lines changed

1 file changed

+22
-3
lines changed

CONTRIBUTING.md

Lines changed: 22 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -79,11 +79,30 @@ If you notice something wrong in the text or code samples, please follow our [de
7979

8080
All of the content on graphql.org is written and formatted in [Markdown](https://www.gatsbyjs.com/docs/mdx/markdown-syntax/).
8181

82-
### Add a library or tool to the Code page
82+
### Add a library, tool, or service to the Code page
8383

84-
The [Code page](https://graphql.org/code/) is a collection of libraries, tools, and services built for GraphQL.
84+
The [Code page](https://graphql.org/code/) is a collection of libraries, tools, and services built for GraphQL.
8585

86-
To add your resource to this page, follow our [development guide](#development-guide) to [open a pull request](https://github.com/graphql/graphql.github.io/pulls).
86+
#### General guidelines
87+
88+
**Adding a resource:**
89+
- With rare exceptions, any pull request that adds a new library, tool, or service to the Code page will be accepted.
90+
- Any library should include a few paragraphs describing the usage and offering people a chance to grok the project priorities.
91+
- If there isn't a section already for your programming language, please add it.
92+
93+
If it isn't a library, tool, or service - then it could go on the [Community page](#add-a-resource-to-the-community-page). If you aren't sure where your resource would fit, you can [open an issue](https://github.com/graphql/graphql.github.io/issues/new) and ask.
94+
95+
**Removing a resource:**
96+
- Services that don't work anymore
97+
- Code repositories that are archived
98+
- Projects declared to be abandoned by their maintainers
99+
- Any link that 404s
100+
101+
We rely on these concrete signals before removing a resource. Even if a project hasn't been released in a few years, that doesn't mean that it's not working.
102+
103+
#### Workflow
104+
105+
To add or remove a resource to this page, follow our [development guide](#development-guide) to [open a pull request](https://github.com/graphql/graphql.github.io/pulls).
87106

88107
The content for this page is located in [various directories under `src/content/code`](./src/). Everything is written and formatted in [Markdown](https://www.gatsbyjs.com/docs/mdx/markdown-syntax/).
89108

0 commit comments

Comments
 (0)