Add instruction for running unit tests in parallel (#13928)

2 files changed, 7 insertions, 0 deletions

diff --git a/changelog.d/13928.doc b/changelog.d/13928.doc
new file mode 100644

index 0000000000..04cd06f19d
--- /dev/null
+++ b/changelog.d/13928.doc
@@ -0,0 +1 @@
+Add instruction to contributing guide for running unit tests in parallel. Contributed by @ashfame.
diff --git a/docs/development/contributing_guide.md b/docs/development/contributing_guide.md

index cb0d727efa..5c37225168 100644
--- a/docs/development/contributing_guide.md
+++ b/docs/development/contributing_guide.md
@@ -167,6 +167,12 @@ was broken. They are slower than the linters but will typically catch more error
 poetry run trial tests
 ```
 
+You can run unit tests in parallel by specifying `-jX` argument to `trial` where `X` is the number of parallel runners you want. To use 4 cpu cores, you would run them like:
+
+```sh
+poetry run trial -j4 tests
+```
+
 If you wish to only run *some* unit tests, you may specify
 another module instead of `tests` - or a test class or a method: