Update ``primer`` tests to own file, separate batches and concurrent runs (#5425)

1 files changed, 8 insertions, 1 deletions

diff --git a/doc/development_guide/testing.rst b/doc/development_guide/testing.rst
index 3cdee7c90..85d1043ef 100644
--- a/doc/development_guide/testing.rst
+++ b/doc/development_guide/testing.rst
@@ -148,7 +148,14 @@ on the ``stdlib`` and a selection of external repositories.
 To run the ``primer`` tests you can add either ``--primer-stdlib`` or ``--primer-external`` to the
 pytest_ command. If you want to only run the ``primer`` you can add either of their marks, for example::
 
-    pytest -m primer_external --primer-external
+    pytest -m primer_stdlib --primer-stdlib
+
+The external ``primer`` has been split up in two marks to speed up our Continuous Integration. You can run
+either of the two batches or run them both::
+
+    pytest -m primer_external_batch_one --primer-external # Runs batch one
+    pytest -m primer_external_batch_two --primer-external # Runs batch two
+    pytest -m "primer_external_batch_one or primer_external_batch_two" --primer-external # Runs both batches
 
 The list of repositories is created on the basis of three criteria: 1) projects need to use a diverse
 range of language features, 2) projects need to be well maintained and 3) projects should not have a codebase