Add comments

.github/actions/install-aiida-core/action.yml

@@ -12,6 +12,9 @@ inputs:
     required: false
   # NOTE: Hard-learned lesson: we cannot use type=boolean here, apparently :-(
   # https://stackoverflow.com/a/76294014
+  # NOTE2: When installing from lockfile, aiida-core and its dependencies
+  # are installed in a virtual environment located in .venv directory.
+  # Subsuquent jobs steps must either activate the environment or use `uv run`
   from-lock:
     description: Install aiida-core dependencies from a uv lock file
     default: 'true'
@@ -31,8 +34,10 @@ runs:
       version: 0.5.5
 
   - name: Install dependencies from uv lock
-    # NOTE: We're also asserting that the lockfile is up to date
     if: ${{ inputs.from-lock == 'true' }}
+    # NOTE: We're asserting that the lockfile is up to date
+    # NOTE2: 'pre-commit' extra recursively contains other extras
+    # needed to run the tests.
     run: uv sync --locked --extra pre-commit
     shell: bash
 

.github/workflows/ci-code.yml

@@ -64,6 +64,7 @@ jobs:
         python-version: ${{ matrix.python-version }}
 
     - name: Setup environment
+      # Note: The virtual environment in .venv was created by uv in previous step
       run: source .venv/bin/activate && .github/workflows/setup.sh
 
     - name: Run test suite