Re: (ofbiz-framework) branch trunk updated: Improved: Fix Javadoc warnings (OFBIZ-12742)

[Jacques Le Roux]

Le 14/03/2025 à 17:24, jler...@apache.org a écrit :

     Improved: Fix Javadoc warnings (OFBIZ-12742)

Slightly improves AbstractCache class. But I don't understand yet why it still

     claims that:

AbstractCache.java:23: warning: no comment

     public abstract class AbstractCache {
                     ^
     AbstractCache.java:27: warning: no comment
         protected AbstractCache(String id) {

Actually the way most Abstract classes are currently documented in OFBiz is 
wrong.
Sincerely removing the warnings above is not obvious.
It's recommended to use @inheritdoc from classes extending the Abstract classes
https://stackoverflow.com/questions/2165008/javadoc-inheritdoc-tag-class
https://docs.oracle.com/en/java/javase/17/docs/specs/javadoc/doc-comment-spec.html
https://www.baeldung.com/javadoc-see-vs-link

We have none of such currently... A lot of work ahead...

Jacques