doc(Repository): Add more comments to Deserializer

Signed-off-by: Jens Keim <[email protected]>

Author: pepper-jk

model/src/main/kotlin/Repository.kt

@@ -89,23 +89,27 @@ private class RepositoryDeserializer : StdDeserializer<Repository>(Repository::c
     override fun deserialize(p: JsonParser, ctxt: DeserializationContext): Repository {
         val node = p.codec.readTree<JsonNode>(p)
         val parsedProvenance = when {
-            // Parse [vcs] attribute and create a Repository
             node.has("vcs") -> {
+                // Parse [vcs] and [vcsProcessed] attributes
                 val vcsInfo = jsonMapper.treeToValue<VcsInfo>(node["vcs"])
                 val vcsProcess = jsonMapper.treeToValue<VcsInfo>(node["vcs_processed"])
 
+                // Get the [vcs]'s revision
                 val resolvedRevision = if (vcsInfo.revision != "") {
                     vcsInfo.revision
                 } else if (vcsProcess.revision != "") {
+                    // Fall back to [vcsProcessed], if [vcs] has empty revision
                     vcsProcess.revision
                 } else {
                     HashAlgorithm.SHA1.emptyValue
                 }
 
+                // Build a RepositoryProvenance from the parsed VcsInfo fields
                 RepositoryProvenance(vcsInfo, resolvedRevision)
             }
 
             else -> {
+                // Parse the [provenance], if no legacy fields are present
                 jsonMapper.treeToValue<RepositoryProvenance>(node["provenance"])
             }
         }