From: Iker Pedrosa <ipedrosa@redhat.com>
Date: Tue, 26 Aug 2025 11:00:11 +0000 (+0200)
Subject: doc/contributions/ci.md: document system tests
X-Git-Tag: 4.19.0-rc1~59
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=e53545851d28a5a40e72ea47132a789bf255b27c;p=thirdparty%2Fshadow.git

doc/contributions/ci.md: document system tests

Extend the system tests section.

Signed-off-by: Iker Pedrosa <ipedrosa@redhat.com>
---

diff --git a/doc/contributions/ci.md b/doc/contributions/ci.md
index 04755d403..d83da903c 100644
--- a/doc/contributions/ci.md
+++ b/doc/contributions/ci.md
@@ -12,9 +12,27 @@ be triggered locally by following the instructions specified in the
 
 ## System tests
 
-The project is tested on Ubuntu. For that purpose it is built & installed in
-this distribution in a VM. You can run this step locally by following the
-instructions provided in the [Tests](tests.md#system-tests) page.
+The project runs system tests to verify functionality
+across different environments
+using two complementary approaches:
+
+### Bash system tests
+
+Legacy Bash system tests run on Ubuntu in a VM environment.
+These provide coverage for Ubuntu-specific scenarios and legacy test cases.
+You can run this step locally by following the instructions provided
+in the [Tests](tests.md#bash-system-tests) page.
+
+### Python system tests
+
+The new Python system tests use pytest and pytest-mh,
+running across multiple distributions (Fedora, Debian, Alpine, openSUSE)
+in containerized environments.
+These tests provide cross-distribution compatibility
+and improved environment management compared to the Bash tests.
+
+For local execution of Python system tests,
+follow the instructions in the [Tests](tests.md#python-system-tests) page.
 
 ## Static code analysis