diff --git a/content/docs/user-guide/troubleshooting.md b/content/docs/user-guide/troubleshooting.md
index 4555c2939c..4b4036e269 100644
--- a/content/docs/user-guide/troubleshooting.md
+++ b/content/docs/user-guide/troubleshooting.md
@@ -70,6 +70,9 @@ some network filesystem like NFS, Lustre, etc. If so, the solution is to enable
 $ dvc config core.hardlink_lock true
 ```
 
+You can pass the `--wait-for-lock` option to DVC commands to make them wait for
+the lock to be released instead of failing immediately.
+
 ## Cannot add files in symlinked directory {#add-symlink}
 
 DVC only supports [symlinked files](/doc/command-reference/add#add-symlink) as