diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
index 22ac740d..dcac1d85 100644
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -1,6 +1,11 @@
 # -----------------------------------------------------------------------------
 #   - invoked on push, pull_request, or manual trigger
-#   - test under at least 3 versions of python
+#   - tests under multiple versions of python
+#   - only quick tests are run here
+#
+#   NOTE: We do not run tests marked as slow nor do we schedule runs here.
+#   Slow tests and scheduled runs are handled via Jenkins because that has 
+#   access to the cluster which is required for some tests.
 # -----------------------------------------------------------------------------
 name: build
 on: [push, pull_request, workflow_dispatch]
@@ -31,7 +36,7 @@ jobs:
           isort . --check --verbose --only-modified --diff
       - name: Install dependencies
         run: |
-          pip install .[dev]
+          pip install .[test]
       - name: Test
         run: |
           pytest ./tests
diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
index 49293df3..9c458760 100644
--- a/.github/workflows/deploy.yml
+++ b/.github/workflows/deploy.yml
@@ -21,6 +21,9 @@ jobs:
           python -m pip install --upgrade pip
           pip install setuptools wheel build
       - name: Test
+        # NOTE: We only run tests not marked as `slow` here since github actions
+        # does not have access to the cluster (which is required for some tests). 
+        # This means that we may inadvertenlly deploy code that has failing tests!
         run: |
           pip install .[test]
           pytest ./tests