From 9de2feff43b0d1dc3e1f015925409138761cc11c Mon Sep 17 00:00:00 2001
From: Mike Han <mike.han@saucelabs.com>
Date: Fri, 16 Aug 2024 14:52:40 -0600
Subject: [PATCH] Document `allAttempts` feature

---
 .../cucumberjs-playwright/yaml.md             | 19 +++++++++++++++++++
 .../automated-testing/cypress/yaml/v1.md      | 19 +++++++++++++++++++
 .../automated-testing/playwright/yaml.md      | 19 +++++++++++++++++++
 .../web-apps/automated-testing/replay/yaml.md | 19 +++++++++++++++++++
 .../automated-testing/testcafe/yaml.md        | 19 +++++++++++++++++++
 5 files changed, 95 insertions(+)

diff --git a/docs/web-apps/automated-testing/cucumberjs-playwright/yaml.md b/docs/web-apps/automated-testing/cucumberjs-playwright/yaml.md
index 30ecda6083..5c07cbf0e1 100644
--- a/docs/web-apps/automated-testing/cucumberjs-playwright/yaml.md
+++ b/docs/web-apps/automated-testing/cucumberjs-playwright/yaml.md
@@ -784,6 +784,25 @@ artifacts:
 
 ---
 
+#### `allAttempts`
+
+<p><small>| OPTIONAL | BOOLEAN |</small></p>
+
+If you have your tests configured with [retries](#retries), you can set this option to `true` to download artifacts for every attempt. Otherwise, only artifacts of the last attempt
+will be downloaded.
+
+```yaml
+artifacts:
+  download:
+    match:
+      - console.log
+    when: always
+    allAttempts: true
+    directory: ./artifacts/
+```
+
+---
+
 ## `playwright`
 
 <p><small>| REQUIRED | OBJECT |</small></p>
diff --git a/docs/web-apps/automated-testing/cypress/yaml/v1.md b/docs/web-apps/automated-testing/cypress/yaml/v1.md
index f897bdc227..fc015a902f 100644
--- a/docs/web-apps/automated-testing/cypress/yaml/v1.md
+++ b/docs/web-apps/automated-testing/cypress/yaml/v1.md
@@ -812,6 +812,25 @@ artifacts:
 
 ---
 
+#### `allAttempts`
+
+<p><small>| OPTIONAL | BOOLEAN |</small></p>
+
+If you have your tests configured with [retries](#retries), you can set this option to `true` to download artifacts for every attempt. Otherwise, only artifacts of the last attempt
+will be downloaded.
+
+```yaml
+artifacts:
+  download:
+    match:
+      - console.log
+    when: always
+    allAttempts: true
+    directory: ./artifacts/
+```
+
+---
+
 ## `cypress`
 
 <p><small>| REQUIRED | OBJECT |</small></p>
diff --git a/docs/web-apps/automated-testing/playwright/yaml.md b/docs/web-apps/automated-testing/playwright/yaml.md
index 1ecb63c6ef..0363a33938 100644
--- a/docs/web-apps/automated-testing/playwright/yaml.md
+++ b/docs/web-apps/automated-testing/playwright/yaml.md
@@ -788,6 +788,25 @@ artifacts:
 
 ---
 
+#### `allAttempts`
+
+<p><small>| OPTIONAL | BOOLEAN |</small></p>
+
+If you have your tests configured with [retries](#retries), you can set this option to `true` to download artifacts for every attempt. Otherwise, only artifacts of the last attempt
+will be downloaded.
+
+```yaml
+artifacts:
+  download:
+    match:
+      - console.log
+    when: always
+    allAttempts: true
+    directory: ./artifacts/
+```
+
+---
+
 ## `playwright`
 
 <p><small>| REQUIRED | OBJECT |</small></p>
diff --git a/docs/web-apps/automated-testing/replay/yaml.md b/docs/web-apps/automated-testing/replay/yaml.md
index ee90c21065..a001311314 100644
--- a/docs/web-apps/automated-testing/replay/yaml.md
+++ b/docs/web-apps/automated-testing/replay/yaml.md
@@ -509,6 +509,25 @@ artifacts:
 
 ---
 
+#### `allAttempts`
+
+<p><small>| OPTIONAL | BOOLEAN |</small></p>
+
+If you have your tests configured with [retries](#retries), you can set this option to `true` to download artifacts for every attempt. Otherwise, only artifacts of the last attempt
+will be downloaded.
+
+```yaml
+artifacts:
+  download:
+    match:
+      - console.log
+    when: always
+    allAttempts: true
+    directory: ./artifacts/
+```
+
+---
+
 ## `suites`
 
 <p><small>| REQUIRED | OBJECT |</small></p>
diff --git a/docs/web-apps/automated-testing/testcafe/yaml.md b/docs/web-apps/automated-testing/testcafe/yaml.md
index 1f08433602..db2fec7930 100644
--- a/docs/web-apps/automated-testing/testcafe/yaml.md
+++ b/docs/web-apps/automated-testing/testcafe/yaml.md
@@ -792,6 +792,25 @@ artifacts:
 
 ---
 
+#### `allAttempts`
+
+<p><small>| OPTIONAL | BOOLEAN |</small></p>
+
+If you have your tests configured with [retries](#retries), you can set this option to `true` to download artifacts for every attempt. Otherwise, only artifacts of the last attempt
+will be downloaded.
+
+```yaml
+artifacts:
+  download:
+    match:
+      - console.log
+    when: always
+    allAttempts: true
+    directory: ./artifacts/
+```
+
+---
+
 ## `testcafe`
 
 <p><small>| REQUIRED | OBJECT |</small></p>