ci: add notes about pytest --maxfail=2 choice

.github/workflows/integration-test.yaml

@@ -115,6 +115,9 @@ jobs:
       - name: Install pytest
         run: python3 -m pip install pytest
 
+      # We abort pytest after two failures as a compromise between wanting to
+      # avoid a flood of logs while still understanding if multiple tests would
+      # fail.
       - name: Run bootstrap tests
         run: |
           pytest --verbose --maxfail=2 --color=yes --durations=10 --capture=no \