diff --git a/docs/src/dev-docs/building-package.md b/docs/src/dev-docs/building-package.md
index 2964063a4e..528a53dd7f 100644
--- a/docs/src/dev-docs/building-package.md
+++ b/docs/src/dev-docs/building-package.md
@@ -51,11 +51,16 @@ Both flavours contain the same binaries but are configured with different values
 To build the package, run:
 
 ```shell
-task package
+task
 ```
 
 The build will be in `build/clp-package` and defaults to using the storage engine for `clp-text`.
 
+:::{note}
+The `task` command runs `task docker-images:package` under the hood. In addition to the build, a
+Docker image named `clp-package:dev-<user>-<unique-id>` will also be created.
+:::
+
 To build a releasable tar of either flavour, run:
 
 ```shell
@@ -75,16 +80,6 @@ To clean up all build artifacts, run:
 task clean
 ```
 
-## Building a Docker image
-
-To build a Docker image containing the CLP package, run:
-
-```shell
-task docker-images:package
-```
-
-This will create a Docker image named `clp-package:dev`.
-
 [Docker]: https://docs.docker.com/engine/install/
 [Task]: https://taskfile.dev/
 [uv]: https://docs.astral.sh/uv/