diff --git a/docs/cli.md b/docs/cli.md
index 5d5717962a4..a895a9d211f 100644
--- a/docs/cli.md
+++ b/docs/cli.md
@@ -281,7 +281,8 @@ you should use the `update` command.
 poetry update
 ```
 
-This will resolve all dependencies of the project and write the exact versions into `poetry.lock`.
+This will resolve all dependencies of the project, write the exact versions into `poetry.lock`,
+and subsequently update the non-optional dependencies.
 
 If you just want to update a few packages and not all, you can list them as such:
 
@@ -310,6 +311,11 @@ You can do this using the `add` command.
 When `--only` is specified, `--with` and `--without` options are ignored.
 {{% /note %}}
 
+{{% note %}}
+`poetry update` without any options will only update the non-optional dependencies of the project.
+Optional dependency groups are only updated when they are specified through `--with`.
+{{% /note %}}
+
 ## add
 
 The `add` command adds required packages to your `pyproject.toml` and installs them.