diff --git a/docs/docs/cli.md b/docs/docs/cli.md
index af7c8b1a81a..f0b2989a9ad 100644
--- a/docs/docs/cli.md
+++ b/docs/docs/cli.md
@@ -465,6 +465,10 @@ 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
 ```
@@ -472,6 +476,7 @@ poetry lock
 ### Options
 
 * `--check`: Verify that `poetry.lock` is consistent with `pyproject.toml`
+* `--no-update`: Do not update locked versions, only refresh lock file.
 
 ## version