diff --git a/docs/running_psalm/issues/InvalidScalarArgument.md b/docs/running_psalm/issues/InvalidScalarArgument.md
index bc0f97200f9..5a8713736cf 100644
--- a/docs/running_psalm/issues/InvalidScalarArgument.md
+++ b/docs/running_psalm/issues/InvalidScalarArgument.md
@@ -1,6 +1,10 @@
 # InvalidScalarArgument
 
-Emitted when a scalar value is passed to a method that expected another scalar type
+Emitted when a scalar value is passed to a method that expected another scalar type.
+
+This is only emitted in situations where Psalm can be sure that PHP tries to coerce one scalar type to another.
+
+In all other cases `InvalidArgument` is emitted.
 
 ```php
 <?php