Add comments

Author: eregon

ci.jsonnet

@@ -158,7 +158,10 @@ local part_definitions = {
       local url = ["mx", "urlrewrite", "https://github.com/graalvm/graal-enterprise.git"],
             repo = "../graal-enterprise",
             suite_file = "graal-enterprise/mx.graal-enterprise/suite.py",
+            # Find the latest merge commit of a pull request in the graal repo, equal or older than our graal import.
             merge_commit_in_graal = ["git", "-C", "../graal", "log", "--pretty=%H", "--grep=PullRequest:", "--merges", "-n1"] + jt(["truffle_version"]),
+            # Find the commit importing that version of graal in graal-enterprise by looking at the suite file.
+            # The suite file is automatically updated on every graal PR merged.
             graal_enterprise_commit = ["git", "-C", repo, "log", "--pretty=%H", "--grep=PullRequest:", "--reverse", "-m", "-S", merge_commit_in_graal, suite_file, "|", "head", "-1"];
       [
         ["git", "clone", url, repo],