Skip to content

Commit

Permalink
docs: explain limitation on amount of branches that can be automerged…
Browse files Browse the repository at this point in the history
… in one run (#11890)
  • Loading branch information
HonkingGoose committed Sep 27, 2021
1 parent fc36b27 commit 54c1ccd
Showing 1 changed file with 6 additions and 0 deletions.
6 changes: 6 additions & 0 deletions docs/usage/key-concepts/automerge.md
Expand Up @@ -12,6 +12,12 @@ Keep in mind that Renovate automerges take a bit of time, do not expect Renovate
Wait for at least an hour or two before troubleshooting to ensure that Renovate has had the time to run once in a state where tests have passed and the branch is up-to-date with its base branch.
If you or others keep committing to the default branch then Renovate cannot find a suitable gap to automerge into!

Once a branch is automerged, the "Git state" needs to be recalculated for every remaining branch.
At times, merging one branch could result in another branch's updates being changed or even removed as unnecessary.
Renovate's approach is to ensure that automerging branches are up-to-date with their target branch before automerging.
Therefore merging multiple branches in a row won't reliably work, we prefer not to do that.
What all this means is that Renovate will only automerge at most one branch/PR per target branch per run, before you need to wait for the next run.

As a general guide, we recommend that you enable automerge for any type of dependency updates where you would just click "merge" anyway.
For any updates where you want to review the release notes - or code - before you merge, you can keep automerge disabled.

Expand Down

0 comments on commit 54c1ccd

Please sign in to comment.