Skip to content

This issue was moved to a discussion.

You can continue the conversation there. Go to discussion →

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Docs: Gatsby Governance Model #11805

Closed
marcysutton opened this issue Feb 15, 2019 · 4 comments
Closed

Docs: Gatsby Governance Model #11805

marcysutton opened this issue Feb 15, 2019 · 4 comments
Labels
type: documentation An issue or pull request for improving or updating Gatsby's documentation

Comments

@marcysutton
Copy link
Contributor

In the new contributing docs, it would be good to document Gatsby's Governance Model. From oss-watch:

A governance model describes the roles that project participants can take on and the process for decision making within the project. In addition, it describes the ground rules for participation in the project and the processes for communicating and sharing within the project team and community. In other words it is the governance model that prevents an open source project from descending into chaos.

We have an RFC process, and this document could sit alongside it to communicate more about the Gatsby process to contributors.

Here is the Vue.js version: https://github.com/vuejs/vue/wiki/Governance-Document

To close this issue, we need to write a governance model for Gatsby and include the content in the contributing section.
@gatsbot gatsbot bot added the type: documentation An issue or pull request for improving or updating Gatsby's documentation label Feb 15, 2019
@marcysutton marcysutton mentioned this issue Feb 16, 2019
Merged
DSchau pushed a commit that referenced this issue Feb 19, 2019
@marcysutton @DSchau
docs: new section for contributing (#11812)
d14137c 
## Description

As per [rfc/29](gatsbyjs/rfcs#29), this PR introduces a major change to the Gatsby docs: a new `/contributing` section. I did a big find and replace to update all links, and there are also redirects for pages that moved.

This is a pretty large PR, and I welcome any and all feedback on the new structure and content. My only request is that we try to resolve any feedback quickly so that community PRs aren't working on outdated stuff.

Here's a screenshot of the new Contributing landing page:

![contributing landing page](https://user-images.githubusercontent.com/1045233/52890806-938f8a00-313b-11e9-8645-c4991fc95fa3.png)

## Related Issues

Fixes #11803, Fixes #8847 

## Outstanding questions
- Do we need to make any additional changes to CODEOWNERS?
- I included a link to `/contributing` in the docs sidebar to ease the transition. Should the link use some kind of icon to distinguish that it takes the user away from the docs?
- Should we add a new icon to the mobile nav (I didn't make any mobile changes in this PR)?
- Any changes to the sidebar, specifically around accordions?

## Subsequent related issues/stubs

- Gatsby Governance Model: #11805
- Triaging GitHub Issues: #11810
gatsbybot pushed a commit to gatsbyjs/gatsby-starter-blog that referenced this issue Feb 19, 2019
docs: new section for contributing (#11812)
bad0b35 
## Description

As per [rfc/29](gatsbyjs/rfcs#29), this PR introduces a major change to the Gatsby docs: a new `/contributing` section. I did a big find and replace to update all links, and there are also redirects for pages that moved.

This is a pretty large PR, and I welcome any and all feedback on the new structure and content. My only request is that we try to resolve any feedback quickly so that community PRs aren't working on outdated stuff.

Here's a screenshot of the new Contributing landing page:

![contributing landing page](https://user-images.githubusercontent.com/1045233/52890806-938f8a00-313b-11e9-8645-c4991fc95fa3.png)

## Related Issues

Fixes #11803, Fixes #8847

## Outstanding questions
- Do we need to make any additional changes to CODEOWNERS?
- I included a link to `/contributing` in the docs sidebar to ease the transition. Should the link use some kind of icon to distinguish that it takes the user away from the docs?
- Should we add a new icon to the mobile nav (I didn't make any mobile changes in this PR)?
- Any changes to the sidebar, specifically around accordions?

## Subsequent related issues/stubs

- Gatsby Governance Model: gatsbyjs/gatsby#11805
- Triaging GitHub Issues: gatsbyjs/gatsby#11810
gatsbybot pushed a commit to gatsbyjs/gatsby-starter-default that referenced this issue Feb 19, 2019
docs: new section for contributing (#11812)
734d5a8 
## Description

As per [rfc/29](gatsbyjs/rfcs#29), this PR introduces a major change to the Gatsby docs: a new `/contributing` section. I did a big find and replace to update all links, and there are also redirects for pages that moved.

This is a pretty large PR, and I welcome any and all feedback on the new structure and content. My only request is that we try to resolve any feedback quickly so that community PRs aren't working on outdated stuff.

Here's a screenshot of the new Contributing landing page:

![contributing landing page](https://user-images.githubusercontent.com/1045233/52890806-938f8a00-313b-11e9-8645-c4991fc95fa3.png)

## Related Issues

Fixes #11803, Fixes #8847

## Outstanding questions
- Do we need to make any additional changes to CODEOWNERS?
- I included a link to `/contributing` in the docs sidebar to ease the transition. Should the link use some kind of icon to distinguish that it takes the user away from the docs?
- Should we add a new icon to the mobile nav (I didn't make any mobile changes in this PR)?
- Any changes to the sidebar, specifically around accordions?

## Subsequent related issues/stubs

- Gatsby Governance Model: gatsbyjs/gatsby#11805
- Triaging GitHub Issues: gatsbyjs/gatsby#11810
@gatsbot gatsbot bot added the stale? Issue that may be closed soon due to the original author not responding any more. label Mar 8, 2019
@gatsbot
Copy link

gatsbot bot commented Mar 8, 2019

Hiya!

This issue has gone quiet. Spooky quiet. 👻

We get a lot of issues, so we currently close issues after 30 days of inactivity. It’s been at least 20 days since the last update here.

If we missed this issue or if you want to keep it open, please reply here. You can also add the label "not stale" to keep this issue open!

Thanks for being a part of the Gatsby community! 💪💜

@pieh pieh added not stale and removed stale? Issue that may be closed soon due to the original author not responding any more. labels Mar 8, 2019
@marcysutton
Copy link
Contributor Author

Hey @calcsam, any interest in helping us work on this governance model doc? Your work on the Gatsby Philosophy doc was so appreciated!

On a related note, it's worth looking to the Wordpress community for examples of why we need governance outlined and followed. Here's a thread for some food for thought: https://twitter.com/mor10/status/1113223629804699648

ish-xyz pushed a commit to ish-xyz/ish-ar.io that referenced this issue Dec 5, 2019
docs: new section for contributing (#11812)
2178e24 
## Description

As per [rfc/29](gatsbyjs/rfcs#29), this PR introduces a major change to the Gatsby docs: a new `/contributing` section. I did a big find and replace to update all links, and there are also redirects for pages that moved.

This is a pretty large PR, and I welcome any and all feedback on the new structure and content. My only request is that we try to resolve any feedback quickly so that community PRs aren't working on outdated stuff.

Here's a screenshot of the new Contributing landing page:

![contributing landing page](https://user-images.githubusercontent.com/1045233/52890806-938f8a00-313b-11e9-8645-c4991fc95fa3.png)

## Related Issues

Fixes #11803, Fixes #8847

## Outstanding questions
- Do we need to make any additional changes to CODEOWNERS?
- I included a link to `/contributing` in the docs sidebar to ease the transition. Should the link use some kind of icon to distinguish that it takes the user away from the docs?
- Should we add a new icon to the mobile nav (I didn't make any mobile changes in this PR)?
- Any changes to the sidebar, specifically around accordions?

## Subsequent related issues/stubs

- Gatsby Governance Model: gatsbyjs/gatsby#11805
- Triaging GitHub Issues: gatsbyjs/gatsby#11810
This was referenced Mar 7, 2020
Open
Open
@mbappai
Copy link

mbappai commented May 31, 2020

@marcysutton Hey! I'd like to try working on this issue if it's still up for grabs. With adequate provision of guidance from you, I'm sure I can make it work. Thanks.

@caitlinthefirst
Copy link
Contributor

Hey, @Mujeex ! I have a draft that's been "in progress" for a while that I'd love another set of eyes on. If you email me at caitlin@gatsbyjs.com, I can share the doc with you. Thanks!

@caitlinthefirst caitlinthefirst mentioned this issue Jun 29, 2020
Merged
idev-a pushed a commit to idev-a/landing-page-gatsby that referenced this issue Dec 14, 2020
docs: new section for contributing (#11812)
42cee01 
## Description

As per [rfc/29](gatsbyjs/rfcs#29), this PR introduces a major change to the Gatsby docs: a new `/contributing` section. I did a big find and replace to update all links, and there are also redirects for pages that moved.

This is a pretty large PR, and I welcome any and all feedback on the new structure and content. My only request is that we try to resolve any feedback quickly so that community PRs aren't working on outdated stuff.

Here's a screenshot of the new Contributing landing page:

![contributing landing page](https://user-images.githubusercontent.com/1045233/52890806-938f8a00-313b-11e9-8645-c4991fc95fa3.png)

## Related Issues

Fixes #11803, Fixes #8847

## Outstanding questions
- Do we need to make any additional changes to CODEOWNERS?
- I included a link to `/contributing` in the docs sidebar to ease the transition. Should the link use some kind of icon to distinguish that it takes the user away from the docs?
- Should we add a new icon to the mobile nav (I didn't make any mobile changes in this PR)?
- Any changes to the sidebar, specifically around accordions?

## Subsequent related issues/stubs

- Gatsby Governance Model: gatsbyjs/gatsby#11805
- Triaging GitHub Issues: gatsbyjs/gatsby#11810
@LekoArts LekoArts closed this as completed May 4, 2021
@gatsbyjs gatsbyjs locked and limited conversation to collaborators May 4, 2021
@LekoArts LekoArts removed the not stale label May 7, 2021

This issue was moved to a discussion.

You can continue the conversation there. Go to discussion →

Assignees
No one assigned
Labels
type: documentation An issue or pull request for improving or updating Gatsby's documentation
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
6 participants
@pieh @marcysutton @marisamorby @LekoArts @caitlinthefirst @mbappai