fix: javadoc for fails snapshot release (#1000)

Author: csviri

operator-framework-core/src/main/java/io/javaoperatorsdk/operator/processing/dependent/external/AbstractSimpleDependentResource.java

@@ -34,7 +34,12 @@ public Optional<R> getResource(HasMetadata primaryResource) {
     return cache.get(ResourceID.fromResource(primaryResource));
   }
 
-  /** Actually read the resource from the target API */
+  /**
+   * Actually read the resource from the target API
+   *
+   * @param primaryResource the primary associated resource
+   * @return fetched resource if present
+   **/
   public abstract Optional<R> fetchResource(HasMetadata primaryResource);
 
   @Override

operator-framework-core/src/main/java/io/javaoperatorsdk/operator/processing/event/ExternalResourceCachingEventSource.java

@@ -5,8 +5,7 @@
 import io.javaoperatorsdk.operator.processing.event.source.CachingEventSource;
 
 public class ExternalResourceCachingEventSource<R, P extends HasMetadata>
-    extends CachingEventSource<R, P>
-    implements RecentOperationCacheFiller<R> {
+    extends CachingEventSource<R, P> implements RecentOperationCacheFiller<R> {
 
   public ExternalResourceCachingEventSource(Class<R> resourceClass) {
     super(resourceClass);

operator-framework-core/src/main/java/io/javaoperatorsdk/operator/processing/event/source/CachingEventSource.java

@@ -10,12 +10,6 @@
 /**
  * Base class for event sources with caching capabilities.
  * <p>
- * {@link #handleDelete(ResourceID)} - if the related resource is present in the cache it is removed
- * and event propagated. There is no event propagated if the resource is not in the cache.
- * <p>
- * {@link #handleEvent(Object, ResourceID)} - caches the resource if changed or missing. Propagates
- * an event if the resource is new or not equals to the one in the cache, and if accepted by the
- * filter if one is present.
  *
  * @param <R> represents the type of resources (usually external non-kubernetes ones) being handled.
  */