From da4e908d8ff3f11fdc1fd19f70381cc1aa075198 Mon Sep 17 00:00:00 2001
From: Olle Haerstedt <olle.haerstedt@limesurvey.org>
Date: Thu, 18 Aug 2022 12:38:14 +0200
Subject: [PATCH] Readme

---
 tests/README.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/tests/README.md b/tests/README.md
index 10012157393..6eaf4ac76d1 100644
--- a/tests/README.md
+++ b/tests/README.md
@@ -9,6 +9,21 @@ Functional tests are divided into back-end (survey administration) and front-end
 
 Unit tests are divided into models, helpers, controllers, etc...
 
+## Debugging
+
+Often, failures happen due to timing issue, or missing wait() or sleep().
+
+Here's one way to debug the CI:
+
+    try {
+        $web->wait(20)->until(WebDriverExpectedCondition::visibilityOfElementLocated(WebDriverBy::cssSelector('#massive-actions-modal-failedemail-grid-resend-1 #preserveResend')));
+    } catch (TimeOutException $ex) {
+        $body = $web->findElement(WebDriverBy::tagName('body'));
+        var_dump($body->getText());
+        throw $ex;
+    }
+
+
 ## Future directions
 
 Something to consider for the future is the time-constraint of the CI. Integrity tests take longer to execute,