diff --git a/web/content/docs/devguide/advanced/gitlab-migration.pandoc b/web/content/docs/devguide/advanced/gitlab-migration.pandoc
index c9279fab7b8cec3bc9192bb20ca641e7e994fa83..d8f2f2c148b79d4812717545b61e253df6a3823e 100644
--- a/web/content/docs/devguide/advanced/gitlab-migration.pandoc
+++ b/web/content/docs/devguide/advanced/gitlab-migration.pandoc
@@ -13,22 +13,26 @@ To migrate your repository run the following commands in your local repository (
 
 ## Disable Git LFS
 
-We used Git LFS to store large files but [switched back to plain git](https://github.com/ufz/ogs/issues/2961). You need to disable Git LFS in your repo:
-
-```bash
-git lfs uninstall --local
-```
+We used Git LFS to store large files but [switched back to plain git](https://github.com/ufz/ogs/issues/2961).
 
 ::: {.note}
-### <i class="far fa-info-circle"></i> Normalize LFS files in your existing branches
+### <i class="far fa-info-circle"></i> IMPORTANT: Normalize LFS files in your existing branches
 If you have branches from pre-GitLab times with e.g. newly created LFS files (benchmark files, images, ...) you have to convert them back to plain git:
 
 ```bash
 git add --renormalize .
 git commit -m "Converted LFS files to plain git."
 ```
+
+Now you have to squash this conversion commit into your original commit which added the files as Git LFS files. In result your branch history should and **must not** have any Git LFS files! Otherwise GitLab will reject the push!
 :::
 
+When you are done migrating your branches you need to disable Git LFS in your local repo:
+
+```bash
+git lfs uninstall --local
+```
+
 ## Create a new fork on GitLab
 
 [Create a new fork](https://gitlab.opengeosys.org/ogs/ogs/-/forks/new) from the [official OGS-6 repository](https://gitlab.opengeosys.org/ogs/ogs).