diff --git a/doc/development/database/batched_background_migrations.md b/doc/development/database/batched_background_migrations.md index 8215561aba362ce8b55a6be1d871a71118bd64a4..7868753d89e2bb0d9fc35408d735b7252cbf6b8a 100644 --- a/doc/development/database/batched_background_migrations.md +++ b/doc/development/database/batched_background_migrations.md @@ -307,8 +307,9 @@ migration code should be. ### Deleting batched background migration code -Once a batched background migration has been finalized, the migration code in `lib/gitlab/background_migration/` -and its associated tests can be deleted after the next required stop following the finalization. +Once a batched background migration has completed, is finalized and has not been [re-queued](#re-queue-batched-background-migrations), +the migration code in `lib/gitlab/background_migration/` and its associated tests can be deleted after the next required stop following +the finalization. Here is an example scenario: