diff --git a/docs/pages/release_notes.md b/docs/pages/release_notes.md
index 708c858408..14e1adb41d 100644
--- a/docs/pages/release_notes.md
+++ b/docs/pages/release_notes.md
@@ -22,7 +22,7 @@ This is a {{ site.pmd.release_type }} release.
 
 ##### For removal
 
-*   {% jdoc !!core::RuleViolationComparator %}
+*   {% jdoc !!core::RuleViolationComparator %}. Use {% jdoc !!core::RuleViolation#DEFAULT_COMPARATOR %} instead.
 
 ### External Contributions