javadoc facelift

Signed-off-by: Attila Mészáros <a_meszaros@apple.com>

Author: csviri

operator-framework-core/src/main/java/io/javaoperatorsdk/operator/api/reconciler/ResourceOperations.java

@@ -37,7 +37,8 @@
 /**
  * Provides useful operations to manipulate resources (server-side apply, patch, etc.) in an
  * idiomatic way, in particular to make sure that the latest version of the resource is present in
- * the caches for the next reconciliation.
+ * the caches for the next reconciliation. In other words provides read-cache-after-write
+ * consistency.
  *
  * @param <P> the resource type on which this object operates
  */

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

@@ -254,8 +254,8 @@ public Stream<R> byIndexStream(String indexName, String indexKey) {
   }
 
   /**
-   * Like {@link #list(String, Predicate)} but providing stronger consistency. This is needed when
-   * resources are updated using {@link
+   * Like {@link #list(String, Predicate)} but for read-cache-after-write consistency. This is
+   * useful when resources are updated using {@link
    * io.javaoperatorsdk.operator.api.reconciler.ResourceOperations}.
    */
   public Stream<R> listWithStrongConsistency(String namespace, Predicate<R> predicate) {
@@ -264,16 +264,17 @@ public Stream<R> listWithStrongConsistency(String namespace, Predicate<R> predic
   }
 
   /**
-   * Like {@link #list(Predicate)} but providing stronger consistency. This is needed when resources
-   * are updated using {@link io.javaoperatorsdk.operator.api.reconciler.ResourceOperations}.
+   * Like {@link #list(Predicate)} but for read-cache-after-write consistency. This is useful when
+   * resources are updated using {@link
+   * io.javaoperatorsdk.operator.api.reconciler.ResourceOperations}.
    */
   public Stream<R> listWithStrongConsistency(Predicate<R> predicate) {
     return mergeWithWithTempCacheResources(cache.list(predicate), null, predicate);
   }
 
   /**
-   * Like {@link #byIndexStream(String, String)} but providing stronger consistency. This is needed
-   * when resources are updated using {@link
+   * Like {@link #byIndexStream(String, String)} but for read-cache-after-write consistency. This is
+   * useful when resources are updated using {@link
    * io.javaoperatorsdk.operator.api.reconciler.ResourceOperations}.
    */
   public Stream<R> byIndexStreamWithStrongConsistency(String indexName, String indexKey) {