Add extra comments (#5158)

Co-authored-by: Simon Dumas <simon.dumas@epfl.ch>

Author: imsdu

delta/sdk/src/main/scala/ch/epfl/bluebrain/nexus/delta/sdk/schemas/job/SchemaValidationCoordinator.scala

@@ -7,6 +7,10 @@ import ch.epfl.bluebrain.nexus.delta.sourcing.stream._
 
 /**
   * Allows to run a revalidation of the different data resouces in the given project
+  *   - Those projections are triggered directy by a a dedicated endpoint
+  *   - It saves its progress and errors the same way as other projections
+  *   - Unlike projections related to indexing, those tasks won't be resumed if Delta gets restarted
+  *   - Running again the validation on aa project will overwrite the previous progress and the related errors
   */
 trait SchemaValidationCoordinator {
 

delta/sdk/src/main/scala/ch/epfl/bluebrain/nexus/delta/sdk/schemas/job/SchemaValidationStream.scala

@@ -16,6 +16,7 @@ import fs2.Stream
 /**
   * Streams the latest version of resources from a project and revalidate them with the latest version of the schema
   * they are currently validated with.
+  *   - Only data resources are evaluated
   *   - Deprecated resources are skipped
   *   - Resources not validated with a schema are skipped too
   */