diff --git a/java/java-impl/src/META-INF/JavaPlugin.xml b/java/java-impl/src/META-INF/JavaPlugin.xml
index 72b30bc467fb..4c735cf39d3b 100644
--- a/java/java-impl/src/META-INF/JavaPlugin.xml
+++ b/java/java-impl/src/META-INF/JavaPlugin.xml
@@ -765,6 +765,11 @@
enabledByDefault="true" level="WARNING"
key="inspection.redundant.comparator.comparing.display.name" bundle="messages.InspectionsBundle"
implementationClass="com.intellij.codeInspection.RedundantComparatorComparingInspection"/>
+
+
+Reports when list.remove(index) is called inside the ascending counted loop. This is suspicious as list becomes
+shorter after that and the element next to removed will not be processed. Simple fix is to decrease the index variable after removal,
+but probably removing via iterator or using removeIf method (since Java 8) is a more robust alternative.
+If you don't expect that remove will be called more than once in a loop, consider adding a break command
+after it.
+
+Since 2018.2
+
+