diff --git a/docs/docs/cli.md b/docs/docs/cli.md
index b051e9346bb..2196c97831f 100644
--- a/docs/docs/cli.md
+++ b/docs/docs/cli.md
@@ -419,10 +419,18 @@ poetry search requests pendulum
 
 This command locks (without installing) the dependencies specified in `pyproject.toml`.
 
+!!!note
+
+     By default, this will lock all dependencies to the latest available compatible versions. To only refresh the lock file, use the `--no-update` option.
+
 ```bash
 poetry lock
 ```
 
+### Options
+
+* `--no-update`: Do not update locked versions, only refresh lock file.
+
 ## version
 
 This command shows the current version of the project or bumps the version of