diff --git a/docs/running_psalm/dealing_with_code_issues.md b/docs/running_psalm/dealing_with_code_issues.md
index 3563820c319..552dede75bc 100644
--- a/docs/running_psalm/dealing_with_code_issues.md
+++ b/docs/running_psalm/dealing_with_code_issues.md
@@ -37,7 +37,7 @@ Some issue types allow the use of `referencedMethod`, `referencedClass` or `refe
   </InvalidReturnType>
   <UndefinedMethod>
     <errorLevel type="suppress">
-      <referencedMethod name="Bar\Bat::bar" />
+      <referencedMethod name="Bar\Bat::bar" /> <!-- not supported for all types of errors -->
       <file name="some_bad_file.php" />
     </errorLevel>
   </UndefinedMethod>