diff --git a/website/docs/source/v2/cli/destroy.html.md b/website/docs/source/v2/cli/destroy.html.md
index 598380cc3..33ec1665b 100644
--- a/website/docs/source/v2/cli/destroy.html.md
+++ b/website/docs/source/v2/cli/destroy.html.md
@@ -12,8 +12,11 @@ destroys all resources that were created during the machine creation process.
 After running this command, your computer should be left at a clean state,
 as if you never created the guest machine in the first place.
 
-This command usually asks for confirmation before destroying. This
-confirmation can be skipped by passing in the `-f` or `--force` flag.
+For linux-based guests, Vagrant uses the `shutdown` command to gracefully
+terminate the machine. Due to the varying nature of operating systems, the
+`shutdown` command may exist at many different locations in the guest's `$PATH`.
+It is the guest machine's responsibility to properly populate the `$PATH` with
+directory containing the `shutdown` command.
 
 ## Options
 
diff --git a/website/docs/source/v2/cli/halt.html.md b/website/docs/source/v2/cli/halt.html.md
index 15091f8a8..0c30a0972 100644
--- a/website/docs/source/v2/cli/halt.html.md
+++ b/website/docs/source/v2/cli/halt.html.md
@@ -13,6 +13,12 @@ Vagrant will first attempt to gracefully shut down the machine by running
 the guest OS shutdown mechanism. If this fails, or if the `--force` flag is
 specified, Vagrant will effectively just shut off power to the machine.
 
+For linux-based guests, Vagrant uses the `shutdown` command to gracefully
+terminate the machine. Due to the varying nature of operating systems, the
+`shutdown` command may exist at many different locations in the guest's `$PATH`.
+It is the guest machine's responsibility to properly populate the `$PATH` with
+directory containing the `shutdown` command.
+
 ## Options
 
 * `-f` or `--force` - Don't attempt to gracefully shut down the machine.