diff --git a/config/checkstyle/checkstyle.xml b/config/checkstyle/checkstyle.xml
index ca472b955df..0b2e6346c9b 100644
--- a/config/checkstyle/checkstyle.xml
+++ b/config/checkstyle/checkstyle.xml
@@ -376,12 +376,12 @@
     JAVADOC CHECKS
     -->
 
-    <!-- Checks that every class, enumeration and interface have a header comment. -->
+    <!-- Checks the Javadoc's format for every class, enumeration and interface. -->
     <module name="JavadocType">
       <property name="allowMissingParamTags" value="true"/>
     </module>
 
-    <!-- Checks that every public method (excluding getters, setters and constructors) has a header comment. -->
+    <!-- Checks the Javadoc's format for every public method (excluding getters, setters and constructors). -->
     <module name="JavadocMethod">
       <property name="allowedAnnotations" value="Override, Test, BeforeAll, BeforeEach, AfterAll, AfterEach, Subscribe"/>
       <property name="accessModifiers" value="public"/>
@@ -393,6 +393,7 @@
 
     <module name="InvalidJavadocPosition"/>
 
+    <!-- Checks that every public method (excluding getters, setters and constructors) has a header comment. -->
     <module name="MissingJavadocMethodCheck">
       <property name="minLineCount" value="1"/>
       <property name="allowMissingPropertyJavadoc" value="true"/>