Skip to content

Commit 1575c88

Browse files
authored
docs: Add Roles section to CONTRIBUTING.md (#2694)
This PR adds a new "Roles" section to the Contributing Guide to clarify Mesa's community structure and progression path. It outlines the different ways community members can contribute and grow within the project: - Describes the Contributor, Collaborator, Maintainer and Special roles - Emphasizes that Mesa welcomes contributions from everyone - Explains GitHub permissions and labels for each role - Encourages reaching out to discuss taking on more responsibility - Reinforces that we're all volunteers working together This documentation aims to make Mesa's governance more transparent and welcoming to new contributors while providing clear paths for increased involvement.
1 parent 661a9c9 commit 1575c88

File tree

1 file changed

+57
-1
lines changed

1 file changed

+57
-1
lines changed

CONTRIBUTING.md

Lines changed: 57 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -119,7 +119,63 @@ ruff .
119119

120120
The license of this project is located in [LICENSE]. By submitting a contribution to this project, you are agreeing that your contribution will be released under the terms of this license.
121121

122-
## Maintainers
122+
## Roles in Mesa
123+
Mesa has several roles to help structure our collaboration and recognize great work. They also form a progression path for community members to that want to take on increasing responsibility in the project. Since we're all volunteers, everyone contributes what they can when they can - there are no minimum time commitments. Also, the best ideas and contributions can come from anyone, these roles are just a way to coordinate our efforts.
124+
125+
Feel free to reach out to us anytime to discuss your interests and ambitions in the project. We're always happy to chat about how you can grow your involvement in Mesa!
126+
127+
### Contributor
128+
Contributors help improve Mesa through:
129+
- Code contributions
130+
- Documentation improvements
131+
- Bug reports and fixes
132+
- Example models
133+
- Tutorial improvements
134+
- Answering questions
135+
- Participating in discussions
136+
- Testing pre-releases
137+
- Sharing Mesa with others
138+
139+
Everyone can contribute what they can, when they can. No contribution is too small! Contributors who have a PR successfully merged receive the "Contributor" label on GitHub.
140+
141+
### Collaborator
142+
When contributors consistently demonstrate technical skills and community mindset through their contributions, they may be invited to become collaborators. Collaborators help coordinate by:
143+
144+
- Reviewing pull requests
145+
- Triaging issues and discussions
146+
- Coordinating between contributors
147+
- Leading specific areas of development
148+
- Helping new contributors
149+
- Participating in project planning
150+
- Building community
151+
152+
The collaborator role recognizes people who help Mesa grow through both their technical contributions and community involvement. Collaborators receive GitHub triage permissions and the "Collaborator" label.
153+
154+
### Maintainer
155+
Maintainers help guide Mesa's overall development while ensuring the project remains sustainable and welcoming. They focus on:
156+
- Project vision and roadmap
157+
- Major architectural decisions
158+
- Release management
159+
- Community governance
160+
- Mentoring collaborators
161+
- Setting community standards
162+
- Long-term sustainability
163+
164+
Maintainers are selected based on their technical expertise, project understanding, and community leadership. Maintainers receive full repository permissions and the "Member" label.
165+
166+
### Special Roles
167+
In some cases, special roles may be created for specific purposes, such as leading particular initiatives or components within Mesa. These roles are created as needed based on project requirements and may come with specific permissions and labels.
168+
169+
All roles are expected to:
170+
- Follow Mesa's code of conduct
171+
- Communicate respectfully
172+
- Work collaboratively
173+
- Help maintain a welcoming community
174+
- Make decisions transparently
175+
176+
Mesa grows through good ideas and contributions. We're all volunteers working together to make Mesa better. Don't hesitate to reach out to any maintainer to discuss your interests and potential growth within the project!
177+
178+
## Maintainers' notes
123179
Some notes useful for Mesa maintainers.
124180

125181
### Releases

0 commit comments

Comments
 (0)