diff --git a/config/checkstyle-checks.xml b/config/checkstyle-checks.xml
index 9e9f0fe18..ea26192f8 100644
--- a/config/checkstyle-checks.xml
+++ b/config/checkstyle-checks.xml
@@ -606,6 +606,10 @@
             <property name="scope" value="public"/>
         </module>
         <module name="JavadocTagContinuationIndentation"/>
+        <module name="JavadocType">
+            <!-- avoid errors on tag '@noinspection' -->
+            <property name="allowUnknownTags" value="true"/>
+        </module>
         <module name="SingleLineJavadoc"/>
 
         <!-- Metrics -->
diff --git a/net.sf.eclipsecs.core/src/net/sf/eclipsecs/core/config/meta/RuleMetadata.java b/net.sf.eclipsecs.core/src/net/sf/eclipsecs/core/config/meta/RuleMetadata.java
index 0cc90a9e7..dbd11ecd7 100644
--- a/net.sf.eclipsecs.core/src/net/sf/eclipsecs/core/config/meta/RuleMetadata.java
+++ b/net.sf.eclipsecs.core/src/net/sf/eclipsecs/core/config/meta/RuleMetadata.java
@@ -26,6 +26,23 @@
 
 /**
  * This class contains the metadata that describes a check rule.
+ *
+ * @param identity
+ *          the identity of the rule (name, internal name, etc.)
+ * @param defaultSeverity
+ *          the default severity level
+ * @param hidden
+ *          <code>true</code> if the rule should be hidden from the user
+ * @param hasSeverity
+ *          <code>true</code> if the rule has a severity level
+ * @param deletable
+ *          <code>true</code> if the rule is deletable
+ * @param isSingleton
+ *          <code>true</code> if the rule is a singleton
+ * @param messageKeys
+ *          the message keys supported by the rule
+ * @param configPropMetadata
+ *          the property metadata for the rule
  */
 public record RuleMetadata(RuleIdentity identity, Severity defaultSeverity, boolean hidden,
         boolean hasSeverity, boolean deletable, boolean isSingleton, List<String> messageKeys,