diff --git a/v3-to-v4.md b/v3-to-v4.md
index 90bdee433..e4b9098f3 100644
--- a/v3-to-v4.md
+++ b/v3-to-v4.md
@@ -114,11 +114,13 @@ repo, rather than changing it after checkout.
 
 The `--change-permissions` flag is no longer supported.
 
-### SSH: `--ssh`
+### SSH: `--ssh` is optional (after v4.0.0)
 
 The old `--ssh` flag is no longer needed - the value of `--repo` determines
 when SSH is used.  It is still accepted but does nothing.
 
+NOTE: v4.0.0 still requires `--ssh` but all releases beyond that do not.
+
 ### Manual: `--man`
 
 The new `--man` flag prints a man-page style help document and exits.