From b9366c936d6cab81dfa5946db960fb01b07f92f5 Mon Sep 17 00:00:00 2001
From: Simon Benzer <simonhbenzer@gmail.com>
Date: Tue, 17 Sep 2024 18:15:08 -0400
Subject: [PATCH 1/4] added more detail to Avoid

---
 .../test_practices/encouraged/avoid_sharing_state.en.md      | 5 +++++
 .../test_practices/encouraged/avoid_sharing_state.ja.md      | 2 ++
 .../test_practices/encouraged/avoid_sharing_state.pt-br.md   | 2 ++
 .../test_practices/encouraged/avoid_sharing_state.zh-cn.md   | 2 ++
 4 files changed, 11 insertions(+)

diff --git a/website_and_docs/content/documentation/test_practices/encouraged/avoid_sharing_state.en.md b/website_and_docs/content/documentation/test_practices/encouraged/avoid_sharing_state.en.md
index be02b1de5833..c72f7f128477 100644
--- a/website_and_docs/content/documentation/test_practices/encouraged/avoid_sharing_state.en.md
+++ b/website_and_docs/content/documentation/test_practices/encouraged/avoid_sharing_state.en.md
@@ -21,3 +21,8 @@ test e.g. invalid order records.
 
 * Create a new WebDriver instance per test. This helps ensure test isolation
 and makes parallelization simpler.
+
+    * If you choose [pytest](https://pytest.org/) as your test runner, this can be 
+    easily done by yielding your driver in a global fixture. This way each test gets its own 
+    driver instance, and you can ensure that drivers always quit after a test is finished 
+    (pass or fail).
diff --git a/website_and_docs/content/documentation/test_practices/encouraged/avoid_sharing_state.ja.md b/website_and_docs/content/documentation/test_practices/encouraged/avoid_sharing_state.ja.md
index 46b2d439fca8..cb37d5d1be8a 100644
--- a/website_and_docs/content/documentation/test_practices/encouraged/avoid_sharing_state.ja.md
+++ b/website_and_docs/content/documentation/test_practices/encouraged/avoid_sharing_state.ja.md
@@ -19,3 +19,5 @@ aliases: [
 
 * テストごとに新しいWebDriverインスタンスを作成します。
 これにより、テストの分離が保証され、並列化がより簡単になります。
+
+    * もしテストランナーとして[pytest](https://pytest.org/)を選ぶ場合、グローバルフィクスチャでドライバーを返すことで簡単に実行できます。この方法を使えば、各テストが独自のドライバーインスタンスを取得し、テストが終了した後（成功・失敗にかかわらず）常にドライバーが終了することを保証できます.
diff --git a/website_and_docs/content/documentation/test_practices/encouraged/avoid_sharing_state.pt-br.md b/website_and_docs/content/documentation/test_practices/encouraged/avoid_sharing_state.pt-br.md
index ec5e65483136..3a0dcf9dfae1 100644
--- a/website_and_docs/content/documentation/test_practices/encouraged/avoid_sharing_state.pt-br.md
+++ b/website_and_docs/content/documentation/test_practices/encouraged/avoid_sharing_state.pt-br.md
@@ -21,3 +21,5 @@ teste, por exemplo registros de pedidos inválidos.
 
 * Crie uma nova instância do WebDriver por teste. Isso ajuda a garantir o isolamento do teste
 e torna a paralelização mais simples.
+
+    * Se você escolher o [pytest](https://pytest.org/) como seu executor de testes, isso pode ser facilmente feito retornando seu driver em um fixture global. Dessa forma, cada teste terá sua própria instância de driver, e você pode garantir que os drivers sempre sejam encerrados após a conclusão de um teste (seja ele aprovado ou reprovado)
diff --git a/website_and_docs/content/documentation/test_practices/encouraged/avoid_sharing_state.zh-cn.md b/website_and_docs/content/documentation/test_practices/encouraged/avoid_sharing_state.zh-cn.md
index da8115aa8f7d..1193e94c2a7e 100644
--- a/website_and_docs/content/documentation/test_practices/encouraged/avoid_sharing_state.zh-cn.md
+++ b/website_and_docs/content/documentation/test_practices/encouraged/avoid_sharing_state.zh-cn.md
@@ -19,3 +19,5 @@ aliases: [
 
 * 每次测试都创建一个新的WebDriver实例. 
 这在确保测试隔离的同时可以保障并行化更为简单.
+
+    * 如果你选择 [pytest](https://pytest.org/) 作为你的测试运行器，可以通过在全局 fixture 中返回你的驱动程序轻松完成。这样，每个测试都会获得自己的驱动程序实例，并且可以确保测试完成后（无论通过还是失败）驱动程序始终会退出

From dadec8a9b8e24f0c5edf31927c56b086397991d1 Mon Sep 17 00:00:00 2001
From: Simon Benzer <69980130+shbenzer@users.noreply.github.com>
Date: Mon, 23 Sep 2024 12:59:02 -0400
Subject: [PATCH 2/4] put back in English - to be tagged for translation

---
 .../test_practices/encouraged/avoid_sharing_state.zh-cn.md   | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/website_and_docs/content/documentation/test_practices/encouraged/avoid_sharing_state.zh-cn.md b/website_and_docs/content/documentation/test_practices/encouraged/avoid_sharing_state.zh-cn.md
index 1193e94c2a7e..b68921f15ec4 100644
--- a/website_and_docs/content/documentation/test_practices/encouraged/avoid_sharing_state.zh-cn.md
+++ b/website_and_docs/content/documentation/test_practices/encouraged/avoid_sharing_state.zh-cn.md
@@ -20,4 +20,7 @@ aliases: [
 * 每次测试都创建一个新的WebDriver实例. 
 这在确保测试隔离的同时可以保障并行化更为简单.
 
-    * 如果你选择 [pytest](https://pytest.org/) 作为你的测试运行器，可以通过在全局 fixture 中返回你的驱动程序轻松完成。这样，每个测试都会获得自己的驱动程序实例，并且可以确保测试完成后（无论通过还是失败）驱动程序始终会退出
+    * If you choose [pytest](https://pytest.org/) as your test runner, this can be 
+    easily done by yielding your driver in a global fixture. This way each test gets its own 
+    driver instance, and you can ensure that drivers always quit after a test is finished 
+    (pass or fail).

From b05c439c0900016a6078b4ccc938690d1f645058 Mon Sep 17 00:00:00 2001
From: Simon Benzer <69980130+shbenzer@users.noreply.github.com>
Date: Mon, 23 Sep 2024 12:59:13 -0400
Subject: [PATCH 3/4] put back in English - to be tagged for translation

---
 .../test_practices/encouraged/avoid_sharing_state.pt-br.md   | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/website_and_docs/content/documentation/test_practices/encouraged/avoid_sharing_state.pt-br.md b/website_and_docs/content/documentation/test_practices/encouraged/avoid_sharing_state.pt-br.md
index 3a0dcf9dfae1..b40d8e89d3ad 100644
--- a/website_and_docs/content/documentation/test_practices/encouraged/avoid_sharing_state.pt-br.md
+++ b/website_and_docs/content/documentation/test_practices/encouraged/avoid_sharing_state.pt-br.md
@@ -22,4 +22,7 @@ teste, por exemplo registros de pedidos inválidos.
 * Crie uma nova instância do WebDriver por teste. Isso ajuda a garantir o isolamento do teste
 e torna a paralelização mais simples.
 
-    * Se você escolher o [pytest](https://pytest.org/) como seu executor de testes, isso pode ser facilmente feito retornando seu driver em um fixture global. Dessa forma, cada teste terá sua própria instância de driver, e você pode garantir que os drivers sempre sejam encerrados após a conclusão de um teste (seja ele aprovado ou reprovado)
+    * If you choose [pytest](https://pytest.org/) as your test runner, this can be 
+    easily done by yielding your driver in a global fixture. This way each test gets its own 
+    driver instance, and you can ensure that drivers always quit after a test is finished 
+    (pass or fail).

From d15573a7cbfa71dda91ebbbf6220fd5db3f5a240 Mon Sep 17 00:00:00 2001
From: Simon Benzer <69980130+shbenzer@users.noreply.github.com>
Date: Mon, 23 Sep 2024 12:59:24 -0400
Subject: [PATCH 4/4] put back in English - to be tagged for translation

---
 .../test_practices/encouraged/avoid_sharing_state.ja.md      | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/website_and_docs/content/documentation/test_practices/encouraged/avoid_sharing_state.ja.md b/website_and_docs/content/documentation/test_practices/encouraged/avoid_sharing_state.ja.md
index cb37d5d1be8a..7ed49b54fc10 100644
--- a/website_and_docs/content/documentation/test_practices/encouraged/avoid_sharing_state.ja.md
+++ b/website_and_docs/content/documentation/test_practices/encouraged/avoid_sharing_state.ja.md
@@ -20,4 +20,7 @@ aliases: [
 * テストごとに新しいWebDriverインスタンスを作成します。
 これにより、テストの分離が保証され、並列化がより簡単になります。
 
-    * もしテストランナーとして[pytest](https://pytest.org/)を選ぶ場合、グローバルフィクスチャでドライバーを返すことで簡単に実行できます。この方法を使えば、各テストが独自のドライバーインスタンスを取得し、テストが終了した後（成功・失敗にかかわらず）常にドライバーが終了することを保証できます.
+    * If you choose [pytest](https://pytest.org/) as your test runner, this can be 
+    easily done by yielding your driver in a global fixture. This way each test gets its own 
+    driver instance, and you can ensure that drivers always quit after a test is finished 
+    (pass or fail).