Do you avoid Merge Debt?

Last updated by Tiago Araújo [SSW] 7 days ago.See history

If you are in a team (i.e. an internal contributor), it is the PR author's responsibility to get a PR reviewed and action feedback ASAP.
As an internal contributor, it's a good idea to have a call with the PR reviewers.

If you are not part of the team (i.e. an outside contributor), reviewing the PR is the responsibility of the repo maintainers. Actioning the feedback is still the responsibility of the PR author. As an outside contributor, it's a good idea to chase the reviewers by reaching out with a comment on GitHub, or through the repo's community (e.g. Discord channels).

Note: Remember that before declaring a task 'Done' with a link, your changes should be live for verification.

When a PR is created but left open for a long time, it becomes stale. Stale PRs equate to merge debt because the longer the PR stays open, the more changes occur on the main branch and the harder it is to merge back in.

Merge debt refers to the amount of work a PR has to undergo before it can be merged into the main branch. If the PR is brand new, the amount of work required to merge is near to none, but as the PR stays open, the more work gets done on the main branch, leading to more work needing to be done to ensure the PR is up-to-date and able to be merged.

Merge debt can be avoided by:

  • Ensuring PRs don't stay open for too long
  • Conducting daily reviews on repos to ensure all PRs that can be merged are merged
  • Ensuring that once a PR is ready to be merged, an "over-the-shoulder" review occurs

Figure: Bad example - Pressing commit and forgetting about it. PR has been left open for a over 2 weeks

over the shoulder pr
Figure: Good example - Devs reviewing a PR on a call - no merge debt!

We open source. Powered by GitHub