diff --git a/share/completions/pip2.fish b/share/completions/pip2.fish
index 894e87634..8cc6457eb 100644
--- a/share/completions/pip2.fish
+++ b/share/completions/pip2.fish
@@ -1,3 +1,7 @@
 if command -sq pip2
+    # pip[2|3] emits (or emitted) completions with the wrong command name
+    # See discussion at https://github.com/fish-shell/fish-shell/pull/4448
+    # and pip bug at https://github.com/pypa/pip/pull/4755
+    # Keep this even after pip fix is upstreamed for users not on the latest pip
     pip2 completion --fish | string replace -r "\b-c\s+pip\b" -- "-c pip2" | source
 end
diff --git a/share/completions/pip3.fish b/share/completions/pip3.fish
index fd12cc224..1d1da95e8 100644
--- a/share/completions/pip3.fish
+++ b/share/completions/pip3.fish
@@ -1,3 +1,7 @@
 if command -sq pip3
+    # pip[2|3] emits (or emitted) completions with the wrong command name
+    # See discussion at https://github.com/fish-shell/fish-shell/pull/4448
+    # and pip bug at https://github.com/pypa/pip/pull/4755
+    # Keep this even after pip fix is upstreamed for users not on the latest pip
     pip3 completion --fish | string replace -r "\b-c\s+pip\b" -- "-c pip3" | source
 end