add comments

Author: rxu17

.github/workflows/ci.yml

@@ -1,5 +1,17 @@
 # This workflow will install Python dependencies, run tests and lint with a single version of Python
 # For more information see: https://help.github.com/actions/language-and-framework-guides/using-python-with-github-actions
+#
+# Only triggers the lint, tests, build container, determine-changes and integration tests jobs for the following conditions: 
+#  - When the PR has the github label "run_integration_tests" AND commits during when pull request is open 
+#  - When it's a push into main or develop branches
+#  - When it's a release event
+# 
+# integration-tests
+# - In addition, the integration-tests job only runs when determine-changes job determines that
+#   there are non-unit tests changes
+#
+# deploy
+# - deploy job only runs when there is a release event
 
 name: build
 
@@ -9,14 +21,12 @@ on:
     paths-ignore:
       - '**.md'                            # All Markdown files
       - '**/docs/**'                       # Documentation directory
-      # - '.github/workflows/**'             # Ignore all github workflow file changes
 
   pull_request:
       types: [opened, reopened, labeled, synchronize]
       paths-ignore:
         - '**.md'                            # All Markdown files
         - '**/docs/**'                       # Documentation directory
-        # - '.github/workflows/**'             # Ignore all github workflow file changes
 
   release:
     types: [created]
@@ -32,9 +42,6 @@ env:
 jobs:
 
   determine-changes:
-    # Only runs for the following conditions: 
-    #  - if github label "run_integration_tests"
-    #  - for commits during when pull request is open OR when it's a push into main or develop branches
     if: >- 
       (
         (