Merge pull request #401 from TypedDevs/codex/fix-alpine-errors-in-parallel-tests

Fix docs for parallel tests

Author: Chemaclass

docs/command-line.md

@@ -129,6 +129,12 @@ Creates a report XML file that follows the JUnit XML format and contains informa
 
 bashunit provides an option to run each test in a separate child process, allowing you to parallelize the test execution and potentially speed up the testing process. When running in parallel mode, the execution order of tests is randomized.
 
+::: warning
+Parallel mode is currently only supported on **macOS** and **Ubuntu**. On other
+systems (like Alpine Linux or Windows) the option is automatically disabled due
+to inconsistent results. In those environments consider using `--no-parallel`.
+:::
+
 ::: code-group
 ```bash [Example]
 ./bashunit ./tests --parallel

docs/configuration.md

@@ -68,6 +68,11 @@ BASHUNIT_SIMPLE_OUTPUT=false
 
 Runs the tests in child processes with randomized execution, which may improve overall testing speed, especially for larger test suites.
 
+::: warning
+Parallel execution is supported only on **macOS** and **Ubuntu**. On other
+systems bashunit forces sequential execution to avoid inconsistent results.
+:::
+
 Similar as using `-p|--parallel` option on the [command line](/command-line#parallel).