Update script comments

Author: pfcoperez

.github/scripts/test-results.sh

@@ -5,16 +5,17 @@ set -eo pipefail # For jq to propagate yq failures.
 # This script processes the XML tests results and outputs a NDJSON stream with one document per test execution.
 # Hence, each document corresponds to a testcase entry in the XML. It contains the following fields:
 #
+#   - 'timestamp': As the testsuite (parent of the entry) timestamp field.
 #   - 'suite_name': As the entry class name.
 #   - 'test': As the entry name.
-#   - 'result': success/failure/pass from the optional child node of the entry. No child node means success.
-#   - 'timestamp': As the testsuite (parent of the entry) timestamp field.
+#   - 'result': success/failure/skipped from the optional child node of the entry. No child node means success.
+#   - 'reason': As the entry child (skipped or failure) contents. For example, in the source, <failure>SOURCE FOR REASON</failure>.
 #   - 'duration_seconds': As the time field of the entry.
-#   - 'reason': As the entry child (pass or failure) contents. For example, in the source, <failure>SOURCE FOR REASON</failure>.
 #   - 'workflow_run_id': As the content of the environment variable 'WORKFLOW_RUN_ID'
 #   - 'workflow_run_link': As the content of the environment variable 'WORKFLOW_RUN_LINK'
-#   - 'workflow_retry_number': As the content of the environment variable 'WORKFLOW_RUN_NUMBER'
 #   - 'workflow_head_branch': As the content of the environment variable 'WORKFLOW_HEAD_BRANCH'
+#   - 'workflow_retry_number': As the content of the environment variable 'WORKFLOW_RUN_NUMBER'
+#   - 'commit_sha': As the content of the environment variable 'COMMIT_SHA'
 #
 # INPUT:
 #   - The XML file(s) to process. For example, the test results generated by JUnit in the 'target/surefire-reports' directory.
@@ -23,6 +24,7 @@ set -eo pipefail # For jq to propagate yq failures.
 #     - WORKFLOW_RUN_LINK
 #     - WORKFLOW_HEAD_BRANCH
 #     - WORKFLOW_RUN_NUMBER
+#     - COMMIT_SHA
 #
 # OUTPUT: NDJSON stream through stdout.
 #