diff --git a/docs/html/topics/vcs-support.md b/docs/html/topics/vcs-support.md
index 465d5ecb78c..86190cc3689 100644
--- a/docs/html/topics/vcs-support.md
+++ b/docs/html/topics/vcs-support.md
@@ -23,6 +23,11 @@ MyProject @ git+file:///home/user/projects/MyProject
 MyProject @ git+https://git.example.com/MyProject
 ```
 
+```{warning}
+Currently, the `MyProject @ git+file` format does not work and the fix requires multiple deprecations.
+See https://github.com/pypa/pip/issues/12124.
+```
+
 ```{warning}
 The use of `git`, `git+git`, and `git+http` schemes is discouraged.
 The former two use [the Git Protocol], which lacks authentication, and HTTP is
diff --git a/news/12124.doc.rst b/news/12124.doc.rst
new file mode 100644
index 00000000000..3657c85300b
--- /dev/null
+++ b/news/12124.doc.rst
@@ -0,0 +1 @@
+Add warning about the ``MyProject @ git+file`` VCS format not working