feat: enable PMD UnusedFormalParameter and Checkstyle's JavadocMethod checks

Author: joaodinissf

ddk-configuration/checkstyle/avaloq.xml

@@ -70,10 +70,23 @@
     <module name="IllegalImport"/>
     <module name="IllegalThrows"/>
     <module name="InterfaceIsType"/>
+    <!-- Internal methods: allow @Override and @Inject; still validate tags when javadoc is present -->
     <module name="JavadocMethod">
+      <property name="accessModifiers" value="package,private"/>
+      <!-- Cover methods + constructors + compact constructors -->
+      <property name="tokens" value="METHOD_DEF,CTOR_DEF,COMPACT_CTOR_DEF"/>
       <property name="allowedAnnotations" value="Override,Inject"/>
-      <property name="accessModifiers" value="package"/>
-      <property name="tokens" value="METHOD_DEF"/>
+      <property name="allowMissingParamTags" value="false"/>
+      <property name="allowMissingReturnTag" value="false"/>
+      <property name="validateThrows" value="true"/>
+    </module>
+    <!-- Public API: enforce tags; no @Inject exemption -->
+    <module name="JavadocMethod">
+      <property name="accessModifiers" value="public,protected"/>
+      <property name="tokens" value="METHOD_DEF,CTOR_DEF,COMPACT_CTOR_DEF"/>
+      <property name="allowMissingParamTags" value="false"/>
+      <property name="allowMissingReturnTag" value="false"/>
+      <property name="validateThrows" value="true"/>
     </module>
     <module name="JavadocType"/>
     <module name="JavadocStyle"/>

ddk-configuration/pmd/ruleset.xml

@@ -90,6 +90,11 @@
     <exclude name="UseTryWithResources"/><!--TODO-->
     <exclude name="JUnit5TestShouldBePackagePrivate"/>
   </rule>
+  <rule ref="category/java/bestpractices.xml/UnusedFormalParameter">
+    <properties>
+        <property name="checkAll" value="true" />
+    </properties>
+  </rule>
   <rule ref="category/java/codestyle.xml">
     <exclude name="AtLeastOneConstructor"/>
     <exclude name="CallSuperInConstructor"/>