Skip to content

Commit f46458a

Browse files
LekoArtsascorbic
andauthored
chore(docs): Clarify wording on governance doc (#35017)
* chore(docs): Clarify governance doc * Update docs/contributing/gatsby-governance-model.md Co-authored-by: Matt Kane <[email protected]> * Update gatsby-governance-model.md Co-authored-by: Matt Kane <[email protected]>
1 parent e7d08e2 commit f46458a

File tree

1 file changed

+9
-9
lines changed

1 file changed

+9
-9
lines changed

docs/contributing/gatsby-governance-model.md

+9-9
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ The [Gatsby User Collective](https://gatsbyuc.dev/)'s goal is to democratize the
2020

2121
### Areas for contribution
2222

23-
As the core of Gatsby is a complex piece of software, it requires some onboarding before contributions can be made efficiently. We're clearly defining here in which areas we accept contributions at the moment and in which not. This is especially important for new features as they always have an inherent maintenance cost -- and making changes without the complete context around Gatsby is difficult. _This list is not set in stone and can change when e.g. a "Core Maintainer (L3)" role is introduced._
23+
As the core of Gatsby is a complex piece of software, it requires some onboarding before contributions can be made efficiently. We're clearly defining here in which areas we accept contributions without any prior interaction with the team at the moment and in which not. This is especially important for new features as they always have an inherent maintenance cost -- and making changes without the complete context around Gatsby is difficult. _This list is not set in stone and can change when e.g. a "Core Maintainer (L3)" role is introduced._
2424

2525
We accept all types of contributions to:
2626

@@ -30,12 +30,12 @@ We accept all types of contributions to:
3030
- [`e2e-tests`](https://github.com/gatsbyjs/gatsby/tree/master/e2e-tests)
3131
- [`docs`](https://github.com/gatsbyjs/gatsby/tree/master/docs)
3232

33-
We accept all types of contributions to [`packages`](https://github.com/gatsbyjs/gatsby/tree/master/packages) with these exceptions:
33+
We accept all types of contributions to [`packages`](https://github.com/gatsbyjs/gatsby/tree/master/packages) but the following packages have extra requirements:
3434

3535
- [`gatsby`](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby)
3636
- [`gatsby-core-utils/remote-file-utils`](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-core-utils/src/remote-file-utils)
3737

38-
For the areas above we accept a limited set of contribution types, such as bug fixes and documentation updates. To implement new features in these areas you must open a [feature request](#feature-requests) first.
38+
For these two packages, we ask you to open a [feature request](#feature-requests) (or for larger changes an [RFC](/contributing/rfc-process/)) before opening PRs for features. Contributions, such as bug fixes and documentation updates, can be made without any prior interaction with the team and don't require a feature request/RFC.
3939

4040
## Contributor levels
4141

@@ -63,7 +63,7 @@ Have you done something (big or small) to contribute to the health, success, or
6363

6464
#### Privileges
6565

66-
At this time we have no specific privileges for this role. If you have ideas here please let us know!
66+
At this time we have no specific privileges for this role except that you can claim yourself [free Gatsby swag](/contributing/contributor-swag/). If you have ideas here please let us know!
6767

6868
#### Responsibilities
6969

@@ -96,7 +96,7 @@ There is no strict minimum number of contributions needed to reach this level, a
9696

9797
#### Privileges
9898

99-
- All privileges of the [Contributor role](#TODO), plus...
99+
- All privileges of the [Contributor role](#level-1-l1---contributor), plus...
100100
- Invitation to the `@Maintainer` role on [Discord](https://gatsby.dev/discord)
101101
- Invitation to the `Maintainers` team on GitHub.
102102
- New name color on Discord: **Blue**.
@@ -118,7 +118,7 @@ There is no strict minimum number of contributions needed to reach this level, a
118118

119119
#### Nomination
120120

121-
To be nominated, a nominee is expected to already be performing some of the responsibilities of a Maintainer over the course of at least a couple of weeks.
121+
To be nominated, a nominee is expected to already be performing some of the responsibilities of a Maintainer over the course of at least a couple of weeks. You can apply through contacting one of the `@Team` members on Discord who then in turn will trigger a [Voting](#voting) process.
122122

123123
In some rare cases, this role may be revoked by an **Admin**. However, under normal circumstances this role is granted for as long as the contributor wishes to engage with the project.
124124

@@ -130,7 +130,7 @@ Team is a special designation for employees of [Gatsby, Inc.](https://www.gatsby
130130

131131
#### Privileges
132132

133-
- All privileges of the [Maintainer role](#TODO), plus...
133+
- All privileges of the [Maintainer role](#level-2-l2---maintainer), plus...
134134
- `@Team` role on [Discord](https://gatsby.dev/discord)
135135
- New name color on Discord: **Purple**.
136136
- `Team` on GitHub.
@@ -164,7 +164,7 @@ Admin is an additional privilege inside the **Team** and is mainly an administra
164164

165165
#### Privileges
166166

167-
- All privileges of the [Team](#TODO), plus...
167+
- All privileges of the [Team](#team), plus...
168168
- `@Admin` role on [Discord](https://gatsby.dev/discord)
169169
- Administration privileges on GitHub.
170170
- Administration privileges on Discord (optional).
@@ -185,7 +185,7 @@ If you’d like to learn more about how we approach the relationship between our
185185

186186
### Feature requests
187187

188-
Please open a [feature request on GitHub Discussions](https://github.com/gatsbyjs/gatsby/discussions/categories/ideas-feature-requests) to voice your ideas. The **Team** will review incoming requests and give a first assessment.
188+
Please open a [feature request on GitHub Discussions](https://github.com/gatsbyjs/gatsby/discussions/categories/ideas-feature-requests) to voice your ideas. For larger changes please consider opening an [RFC](/contributing/rfc-process/). The **Team** will review incoming requests and give a first assessment.
189189

190190
### RFCs
191191

0 commit comments

Comments
 (0)