diff --git a/docs/multiple-cursors-protocol.rst b/docs/multiple-cursors-protocol.rst
index 00a5ff099..25c7b8da4 100644
--- a/docs/multiple-cursors-protocol.rst
+++ b/docs/multiple-cursors-protocol.rst
@@ -3,6 +3,10 @@ The multiple cursors protocol
 
 .. versionadded:: 0.43.0
 
+.. warning::
+   This protocol is under public discussion in :iss:`8927`. It is subject to
+   change until that discussion is completed.
+
 Many editors support something called *multiple cursors* in which you can make
 the same changes at multiple locations in a file and the editor shows you
 cursors at each of the locations. In a terminal context editors typically