Add javadoc

Author: eschleb

README.md

@@ -38,7 +38,14 @@ public class SomeTask implements InstallAndUpdateTask {
         return true;
     }
 
-    //Optional
+    /*
+     * Defines task that will be executed before this one.
+     * 
+     * Be aware:
+     * JCR queries run on persisted content. Unsaved modifications in the current session are not considered! (e.g. unsaved modifications in earlier executed setup tasks)
+     * 
+     * optional
+     */
     @Override
     public Optional<VersionAwareTask> dependsOn() {
         return Optional.empty();

core/src/main/java/com/merkle/oss/magnolia/setup/task/type/VersionAwareTask.java

@@ -14,6 +14,12 @@ default boolean test(final InstallContext installContext, final Version forVersi
 		return true;
 	}
 
+    /**
+     * Defines task that will be executed before this one.
+     * <br>
+     * <b>Be aware:</b><br>
+     * JCR queries run on persisted content. Unsaved modifications in the current session are not considered! (e.g. unsaved modifications in earlier executed setup tasks)
+     */
 	default Optional<VersionAwareTask> dependsOn() {
 		return Optional.empty();
 	}