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

.github/integration-test.py

@@ -120,6 +120,9 @@ def run_test(image_name, test_name, bootstrap_pip_spec, test_files, upgrade, ins
     )
     run_container_command(
         test_name,
+        # 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.
         '/opt/tljh/hub/bin/python3 -m pytest --verbose --maxfail=2 --color=yes --durations=10 --capture=no {}'.format(
             ' '.join([os.path.join('/srv/src/integration-tests/', f) for f in test_files])
         )