InnerSourceCommons / InnerSourceCommons/InnerSourcePatterns
[Pattern Idea] Maintainer Apprentice
Chưa có ai nhận issue này.
- Ngôn ngữ chính
- HTML
- Star
- 853
- Fork
- 206
- Merge trung bình
- 1 ngày 23 giờ
- Pull request đã merge (30 ngày)
- 2
Mô tả
Title
Maintainer Apprentice
Patlet / Summary
A user wants to work their way into becoming an Approver/Maintainer on an InnerSource repository while being given enough permissions to prove their contributions.
Problem
Sometimes a repository may want to "onboard" maintainers without giving them full write access. This means they are added to a repository to provide content/changes and able to "approve" other changes but not merge them. This could be a form of onboarding or internship on the way to approver or maintainer roles.
Context
From @spier in #669
...our idea with the lower section of the CODEOWNERS file was, that those folks doing the translation work might sort of be "maintainer apprentice", and through their involvement in the project become maintainers eventually
In this particular situation the user was in the CODEOWNERS file but did not have write permissions on the repository. This caused GitHub to label the CODEOWNERS file as having errors.
Forces
What could make this problem difficult?
- the permissions structure in the organization or repository is not present to solve this
Tradeoff(s):
- Knowing a "maintainer apprentice" is given enough permissions to contribute and approve but not merge changes.
Solutions
Any of the following:
- Make sure all reviewers/approvers/maintainers of repositories have write permissions
- Accepting that not all reviewers/approvers/maintainers of repositories have write permissions until earned
- Custom repository or organization roles (if the software allows it) (e.g, Custom Repository Roles)
Resulting Context
What is the situation after the problem has been solved?
The original context is changed indirectly by way of the solution.
Often this section can include discussion of the next possible Patterns/problems introduced.
This section can be short in content - the solution may not introduce new problems or change much context.
Known Instances (optional)
#669
Status
Initial
Author(s) (optional)
@spier
@jmeridth
Hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Hướng nghiên cứu
Bắt đầu với issue #670 và trường hợp đã biết được liên kết #669, sau đó xem xét bối cảnh CODEOWNERS và các vai trò tùy chỉnh của repository được mô tả trong issue. Một pattern hoàn chỉnh cần hoàn thiện phần Resulting Context còn dang dở và ghi lại rõ ràng vấn đề giữa maintainer và apprentice, các đánh đổi, giải pháp và kết quả.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Đánh giá
- Công nghệ
- github, markdown
- Lĩnh vực
- documentation
- Loại issue
- Tài liệu
- Độ khó
- 5/5
- Thời gian dự kiến
- Hơn một tuần
- Mức độ hoạt động
- Đình trệ
- Độ rõ ràng
- Cần làm rõ
- Mức phù hợp với người mới
- 25/100