diff --git a/docs/config-format.md b/docs/config-format.md
index 36ea314..d9d2b56 100644
--- a/docs/config-format.md
+++ b/docs/config-format.md
@@ -16,6 +16,7 @@ Entry    | Description | Default
 `check_version` | Check if a new version of dotdrop is available on github | false
 `chmod_on_import` | Always add a chmod entry on newly imported dotfiles (see `--preserve-mode`) | false
 `clear_workdir` | On `install` clear the `workdir` before installing dotfiles (see `--workdir-clear`) | false
+`compare_workdir` | On `compare` notify on files in `workdir` not tracked by dotdrop | false
 `cmpignore` | List of patterns to ignore when comparing, applied to all dotfiles (enclose in quotes when using wildcards; see [ignore patterns](config.md#ignore-patterns)) | -
 `create` | Create a directory hierarchy when installing dotfiles if it doesn't exist | true
 `default_actions` | List of action keys to execute for all installed dotfiles (See [actions](config-details.md#actions-entry)) | -
diff --git a/docs/usage.md b/docs/usage.md
index 298a810..fef175b 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -112,6 +112,9 @@ To ignore specific patterns, see [the ignore patterns](config.md#ignore-patterns
 
 To completely ignore all files not present in `dotpath` see [Ignore missing](#ignore-missing).
 
+If you want to get notified on files present in the `workdir` but not tracked
+by dotdrop see the [compare_workdir](config-format.md).
+
 For more options, see the usage with `dotdrop --help`.
 
 ## List profiles