Topic
Indicate which topic your proposal falls under:
- Enhance Core Contributor Onboarding
- Improve Collaboration, Communication & Reporting
- Improve Fulfilling Commitments and Planning Processes
- Improve Review Processes
Overview
Finding reviewers for a pull request can be challenging because there is no clear mapping of specific code sections to core contributors who are familiar with them. New contributors, in particular, may struggle to identify suitable reviewers for their pull requests, and it would be beneficial to automate this process.
Solution
We can utilize GitHub’s CODEOWNERS file to automatically notify reviewers on pull requests targeting specific sections of code within each repository. Each CC should be included in these teams as part of the onboarding process. We can already observe this in action in some repositories, such as the CODEOWNERS file in the frontend-app-authoring repository, where @openedx/2u-tnl is included as a reviewer by default due to its inclusion in the CODEOWNERS file.
Some tools which can help generate and maintain codeowners file in large repositories like edx-platform.
https://opensauced.pizza/docs/tools/pizza-cli/codeowners/ : Use this tool to generate initial codeowners file and come up with teams based on repositories and sections of code.
https://github.com/marketplace/actions/codeowners-bot : To allow setting codeowners file in any directory and compile the global codeowners file in a github action.Improve review process by automatically notifying code owners and as result reduce time required for pull request reviews without compromising quality.
Impact
Improve review process by automatically notifying code owners and as result reduce time required for pull request reviews without compromising quality.
Timeline
Generating codeowners file for each repository and creating teams based on code sections and repositories. We’ll need someone with admin privileges to create those teams in github. Estimate: 30-40 hours
Adding github action to compile folder local codeowner files into a single global codeowners file. We also need to update the github pull request template to include information about creating codeowners file along with required teams to include in this file Estimate: 5-10 hours.