From e1218a674972df2319838e6ccf6b329ff65d323b Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sat, 28 Feb 2026 21:19:31 +0000
Subject: [PATCH] Fix CI/CD Integration section in tests/README.md to match
 actual workflow

Co-authored-by: shaypal5 <917954+shaypal5@users.noreply.github.com>
---
 tests/README.md | 23 +++++++++++++++++------
 1 file changed, 17 insertions(+), 6 deletions(-)

diff --git a/tests/README.md b/tests/README.md
index c1637a7d..acb8214f 100644
--- a/tests/README.md
+++ b/tests/README.md
@@ -335,18 +335,29 @@ pytest -n auto
 
 ### GitHub Actions
 
-The CI pipeline tests all backends:
+The CI pipeline runs a matrix job per backend. Each backend uses the commands below:
 
-```yaml
-# Local backends run in parallel
-pytest -m "memory or pickle" -n auto
+```bash
+# Local backends (memory, pickle, and other non-external tests)
+pytest -m "not mongo and not sql and not redis and not s3"
 
-# External backends run sequentially for stability
+# MongoDB backend
 pytest -m mongo
-pytest -m redis
+
+# PostgreSQL/SQL backend
 pytest -m sql
+
+# Redis backend
+pytest -m redis
+
+# S3 backend
+pytest -m s3
 ```
 
+Note: local tests do not use `pytest-xdist` (`-n`) in CI. External backends
+(MongoDB, PostgreSQL, Redis, S3) each run in their own isolated matrix job with
+the corresponding Docker service started beforehand.
+
 ### Environment Variables
 
 - `CACHIER_TEST_VS_DOCKERIZED_MONGO`: Use real MongoDB in CI