diff --git a/doc/manual/src/command-ref/nix-instantiate.md b/doc/manual/src/command-ref/nix-instantiate.md
index 89e106bb0..479c9abcf 100644
--- a/doc/manual/src/command-ref/nix-instantiate.md
+++ b/doc/manual/src/command-ref/nix-instantiate.md
@@ -44,9 +44,10 @@ standard input.
 
     > **Warning**
     >
-    > This option produces ambiguous output which is not suitable for machine
-    > consumption. For example, these two Nix expressions print the same result
-    > despite having different types:
+    > This option produces output which can be parsed as a Nix expression which
+    > will produce a different result than the input expression when evaluated.
+    > For example, these two Nix expressions print the same result despite
+    > having different meaning:
     >
     > ```console
     > $ nix-instantiate --eval --expr '{ a = {}; }'