clean up and add comments

.github/workflows/ci_dbt_core_testing.yml

@@ -106,18 +106,21 @@ jobs:
         with:
           python-version: "3.11"
 
-      - name: "Install python tools & dependencies"
+      - name: "Install python tools"
         run: |
           python -m pip install --user --upgrade pip
           python -m pip --version
-          python -m pip install -r dev-requirements.txt -r editable-requirements.txt
-          python -m pip install tox
-          tox --version
 
-      - name: "Check installed versions"
-        run: pip freeze
+      # tox takes care of installing the correct version of dbt-core dependencies but we need to
+      # install them first s that we can override the dbt-common branch
+      - name: "Manually install dbt-core dependencies"
+        run: |
+          python -m pip install -r dev-requirements.txt -r editable-requirements.txt
 
-      - name: "Update the version of dbt-common@${{ inputs.dbt-common-ref }}"
+      # Since the dbt-common dependency is pinned in dev-requirements.txt we need to force update it
+      # Since tox installs dependencies but doesn't force update, it won't get overridden in the next
+      # step since the requirements will already be met
+      - name: "Force update the version of dbt-common@${{ inputs.dbt-common-ref }}"
         run: |
           pip install pip install git+https://github.com/dbt-labs/dbt-common.git@${{ inputs.dbt-common-ref }} --force-reinstall