Merge Request Roles and Responsibilities

GitLab Data Team MR responsibilities

Merge Request Roles and Responsibilities

Reviewer

All GitLab data team members can, and are encouraged to, perform code review on merge requests of colleagues and community contributors. If you want to review merge requests, you can wait until someone assigns you one, but you are also more than welcome to browse the list of open merge requests and leave any feedback or questions you may have.

Note that while all team members can review all merge requests, the ability to accept merge requests is restricted to code owners.

The responsibility of a reviewer is

  • to review the technical implementation,
  • to ensure the code achieves the business goals,
  • to check the data quality of the data models created.

Code owner

Code ownership is a feature of GitLab that links a project member to specific folders and files in a project. It is meant to answer the questions “who can I ask about this code?” and “who should review changes to this code?”. The goal is to assign 2 or 3 GitLab Team Members (max 4) to a set of folders and files (if possible). With not assigning a big group of people to basically all of our code, we hope to define better ownership and drive better code reviews.

A code owner:

  • is the first contact person to answer questions regarding the code,
  • carries the ownership of the quality of the code,
  • carries the ownership of the results that the code produces,
  • performs MR reviews and accepts merge requests.

How to become a code owner

  1. Create an MR to the CODEOWNERS file with the ownership change you wish to make
    • Explain in the MR body why they are ready to take on that responsibility.
    • Use specific examples of recent MR reviews that they have performed. MRs that introduce very simple changes are good, but should not be the only source of reviews.
  2. Work with the other code owners that already cover the area you wish to join.

Requirements that should be taken into consideration to become a code owner:

  • You should have an advanced understanding of the particular subject area.
  • The MRs you’ve written consistently make it through reviewer and maintainer review without significant required changes.
  • The MRs you’ve reviewed consistently make it through maintainer review without significant additionally required changes.

Maintainer

A maintainer in any of the data team projects is not synonymous with any job title. Here, the data team takes from the precedent set forward by the engineering division on the responsibilities of a maintainer. Every data team project has at least one maintainer, but most have multiple, and some projects (like Analytics) have separate maintainers for dbt and orchestration.

The responsibility of a Maintainer is to ensure that

  • Data team processes are followed,
  • the MR is not conflicting with the broader Data Team architecture, procedures and processes,
  • final review on the MR.

How to become a data team maintainer

We have guidelines for maintainership, but no concrete rules. Maintainers should have an advanced understanding of the GitLab Data projects codebases. Prior to applying for maintainership of a project, a person should gain a good feel for the codebase, expertise in one or more domains, and deep understanding of our coding standards. You’re probably ready to become a maintainer when both of these statements feel true:

  1. You are already a codeowner in multiple subject areas
  2. The MRs you’ve reviewed consistently make it through maintainer review without significant additionally required changes
  3. The MRs you’ve created consistently make it through reviewer and maintainer review without significant required changes

If those subjective requirements are satisfied, this is the process to add yourself as a maintainer:

  1. Create an issue in the relevant project with the title “Add as project maintainer”
  2. Add documentation to the issue for the following:
    • Explain why you are ready to take on the maintainer responsibility
    • Explain the scope of your maintainership (entire project, dbt, python, etc.)
    • Recent MR’s that you have created and reviewed that you believe show your readiness
  3. Once the issue is created, tag all other maintainers
  4. If denied, close the issue and work with your manager for a period of no less than 3 months before applying again
  5. If approved, create a MR to add the maintainership to your team page entry
  6. Assign the MR to your manager and mention the existing maintainers of the relevant project (Infrastructure, Analytics, etc) and area (dbt, Airflow, etc.).
  7. If the existing maintainers do not have significant objections we’ve got ourselves a new maintainer!
  8. An owner of the project will increase your privilege on the project

Merge Request Workflow

Every MR follows the applicable MR template. When a MR is ready for review, assign a code owner for review. When a code owner approves the MR, the MR can be merged by a maintainer. This could be the same person if the code owner is also a maintainer. If not, a maintainer is tagged in the MR, asking for final review and merge.