diff --git a/operator-framework-core/src/main/java/io/javaoperatorsdk/operator/api/ObservedGenerationAware.java b/operator-framework-core/src/main/java/io/javaoperatorsdk/operator/api/ObservedGenerationAware.java
index 79c149e366..370e497652 100644
--- a/operator-framework-core/src/main/java/io/javaoperatorsdk/operator/api/ObservedGenerationAware.java
+++ b/operator-framework-core/src/main/java/io/javaoperatorsdk/operator/api/ObservedGenerationAware.java
@@ -1,5 +1,6 @@
 package io.javaoperatorsdk.operator.api;
 
+import io.fabric8.kubernetes.api.model.HasMetadata;
 import io.fabric8.kubernetes.client.CustomResource;
 import io.javaoperatorsdk.operator.api.reconciler.UpdateControl;
 
@@ -11,10 +12,9 @@
  * is ignored.
  *
  * In order to work the status object returned by CustomResource.getStatus() should not be null. In
- * addition to that from the controller that the
- * {@link UpdateControl#updateStatusSubResource(CustomResource)} or
- * {@link UpdateControl#updateCustomResourceAndStatus(CustomResource)} should be returned. The
- * observed generation is not updated in other cases.
+ * addition to that from the controller that the {@link UpdateControl#updateStatus(HasMetadata)} or
+ * {@link UpdateControl#updateResourceAndStatus(HasMetadata)} should be returned. The observed
+ * generation is not updated in other cases.
  *
  * @see ObservedGenerationAwareStatus
  */
diff --git a/operator-framework-core/src/main/java/io/javaoperatorsdk/operator/api/reconciler/UpdateControl.java b/operator-framework-core/src/main/java/io/javaoperatorsdk/operator/api/reconciler/UpdateControl.java
index dcc997021f..1affc25abd 100644
--- a/operator-framework-core/src/main/java/io/javaoperatorsdk/operator/api/reconciler/UpdateControl.java
+++ b/operator-framework-core/src/main/java/io/javaoperatorsdk/operator/api/reconciler/UpdateControl.java
@@ -31,7 +31,8 @@ public static <T extends HasMetadata> UpdateControl<T> updateStatus(
   /**
    * As a results of this there will be two call to K8S API. First the custom resource will be
    * updates then the status sub-resource.
-   *
+   * 
+   * @param <T> resource type
    * @param customResource - custom resource to use in both API calls
    * @return UpdateControl instance
    */