diff --git a/Makefile b/Makefile
index 7d4b6ac..51f880b 100644
--- a/Makefile
+++ b/Makefile
@@ -4,7 +4,7 @@
 develop: sync
 
 sync:
-	pdm sync --clean
+	pdm sync --clean -v
 
 lock:
 	pdm lock
diff --git a/doc/build-from-source.md b/doc/build-from-source.md
index c6d3f6a..eae5e06 100644
--- a/doc/build-from-source.md
+++ b/doc/build-from-source.md
@@ -215,15 +215,28 @@ pipx install pdm -U
 
 Installing in editable mode is a bit particular with Meson, since editable installations
 are incompatible with isolated builds, meaning that all build dependencies have to be
-installed in the main virtual environment! Fortunatelly, it's not too difficult with
-[PDM]. From the root directory of the repository, just run:
+installed in the main virtual environment! Fortunatelly, it's simple with [PDM].
+
+```{warning}
+You should not run the following commands from a virtual environment not related to Fluidimage.
+```
+
+From the root directory of the repository, just run:
+
+```sh
+pdm sync --clean
+```
+
+This command creates a virtual environment, installs all build and runtime dependencies,
+and finally build/install Fluidimage from source.
+
+Alternativelly, one can split this process in two steps. First, install all dependencies:
 
 ```sh
-pdm install --no-self
+pdm sync --no-self --clean
 ```
 
-This command creates a virtual environment and installs all build and runtime
-dependencies. You can then activate this environment and build/install Fluidimage with:
+You can then activate this environment and build/install Fluidimage with:
 
 ```sh
 . .venv/bin/activate