diff --git a/README.md b/README.md
index cb73bbf..a5ebbe9 100644
--- a/README.md
+++ b/README.md
@@ -630,7 +630,7 @@ See also [Explorer Settings](#explorer-settings "Jump to the Explorer settings")
 |`gitlens.advanced.blame.delayAfterEdit`|Specifies the time (in milliseconds) to wait before re-blaming an unsaved document after an edit. Use 0 to specify an infinite wait
 |`gitlens.advanced.blame.sizeThresholdAfterEdit`|Specifies the maximum document size (in lines) allowed to be re-blamed after an edit while still unsaved. Use 0 to specify no maximum
 |`gitlens.advanced.caching.enabled`|Specifies whether git output will be cached — changing the default is not recommended
-|`gitlens.advanced.git`|Specifies the git path to use
+|`gitlens.advanced.git`|Specifies the path to the git executable to use. Use as a last resort as GitLens will use the built-in `git.path` setting first
 |`gitlens.advanced.fileHistoryFollowsRenames`|Specifies whether file histories will follow renames -- will affect how merge commits are shown in histories
 |`gitlens.advanced.maxListItems`|Specifies the maximum number of items to show in a list. Use 0 to specify no maximum
 |`gitlens.advanced.menus`|Specifies which commands will be added to which menus
diff --git a/package.json b/package.json
index ec0853a..7a4835f 100644
--- a/package.json
+++ b/package.json
@@ -812,7 +812,7 @@
                 "gitlens.advanced.git": {
                     "type": "string",
                     "default": null,
-                    "description": "Specifies the git path to use",
+                    "description": "Specifies the path to the git executable to use. Use as a last resort as GitLens will use the built-in `git.path` setting first",
                     "scope": "window"
                 },
                 "gitlens.advanced.fileHistoryFollowsRenames": {