diff --git a/docs/cli.md b/docs/cli.md
index c5c64ef8149..ffb9b1b7a70 100644
--- a/docs/cli.md
+++ b/docs/cli.md
@@ -520,6 +520,10 @@ If one doesn't exist yet, it will be created.
 poetry shell
 ```
 
+Note that this commmand starts a new shell and activates the virtual environment.
+
+As such, `exit` should be used to properly exit the shell and the virtual environment instead of `deactivate`.
+
 ## check
 
 The `check` command validates the structure of the `pyproject.toml` file