diff --git a/core/phpcs.xml.dist b/core/phpcs.xml.dist
index f756a8c787692b9172a144d9f8519c3108181f75..ae948ae6eb7e18b867e55282d75113cdfb395bcc 100644
--- a/core/phpcs.xml.dist
+++ b/core/phpcs.xml.dist
@@ -225,6 +225,8 @@
 
   <!-- PSR-2 sniffs -->
   <rule ref="PSR2.Classes.PropertyDeclaration">
+     <!-- Silence method name underscore warning which is covered already in
+       Drupal.Classes.PropertyDeclaration. -->
     <exclude name="PSR2.Classes.PropertyDeclaration.Underscore"/>
   </rule>
   <rule ref="PSR2.Namespaces.NamespaceDeclaration"/>