diff --git a/docs/datamodel/links.rst b/docs/datamodel/links.rst
index 6d364d001c3..a7bf130874e 100644
--- a/docs/datamodel/links.rst
+++ b/docs/datamodel/links.rst
@@ -698,7 +698,7 @@ property allows us to modify the link property of the existing link.
 
     .. code-block:: edgeql
 
-        # 🚫
+        # 🚫 Does not work
         insert Movie {
           title := 'The Incredible Hulk',
           characters := {(
@@ -720,7 +720,7 @@ property allows us to modify the link property of the existing link.
 
     .. code-block:: edgeql
 
-        # ✅
+        # ✅ Works!
         insert Movie {
           title := 'The Incredible Hulk',
           characters := assert_distinct((
diff --git a/docs/edgeql/for.rst b/docs/edgeql/for.rst
index 25a112a7def..1babd8f1d80 100644
--- a/docs/edgeql/for.rst
+++ b/docs/edgeql/for.rst
@@ -89,7 +89,7 @@ workaround. For example, you might want to write this conditional:
 
 .. code-block::
 
-    # 🚫
+    # 🚫 Does not work
     with admin := (select User filter .role = 'admin')
     select admin if exists admin
       else (insert User {role := 'admin'});
@@ -99,7 +99,7 @@ Here's how you can accomplish the same thing using the workaround:
 
 .. code-block:: edgeql
 
-    # ✅
+    # ✅ Works!
     with
       admin := (select User filter .role = 'admin'),
       new := (for _ in (select () filter not exists admin) union (
diff --git a/docs/guides/cheatsheet/link_properties.rst b/docs/guides/cheatsheet/link_properties.rst
index 6c15a15e53f..04176bad548 100644
--- a/docs/guides/cheatsheet/link_properties.rst
+++ b/docs/guides/cheatsheet/link_properties.rst
@@ -210,7 +210,7 @@ Querying
 
     .. code-block:: edgeql
 
-        # 🚫
+        # 🚫 Does not work
         insert Movie {
           title := 'The Incredible Hulk',
           actors := {(
@@ -232,7 +232,7 @@ Querying
 
     .. code-block:: edgeql
 
-        # ✅
+        # ✅ Works!
         insert Movie {
           title := 'The Incredible Hulk',
           actors := assert_distinct((