extend explanation of browser per test with additional code examples

Author: jflorez

website_and_docs/content/documentation/test_practices/encouraged/fresh_browser_per_test.en.md

@@ -18,28 +18,27 @@ known state with a new user profile, by default.
 A new browser per test can be achieved by using a test framework's "before each test" hook or fixture. This also implies using the "after each test" hook to close the browser.
 
 ```java
-# Using a class variable
+// Using a class variable
 public abstract class BaseTest {
 	protected WebDriver driver;
     ...
 
-    # Before each test hook
+    // Before each test hook
     public void setupTest() {
         driver = new FirefoxDriver();
         ...
     }
 
-    # After each test hook
+    // After each test hook
     public void teardownTest() {
         ...
         driver.quit();
     }
 }
 ```
 
-Using python fixtures
-
 ```python
+# Using python fixtures
 @pytest.fixture(autouse=True, scope='function')
 def driver(self, request, page: Page):
     # Create the driver
@@ -64,7 +63,7 @@ A static WebDriver will cause multiple issues both with parallel test execution
 public abstract class BaseTest {
 	protected ThreadLocal<WebDriver> driver;
     ...
-    # Before each test hook
+    // Before each test hook
     public void setupTest() {
         BaseTest.driver = ThreadLocal.withInitial(()->new FirefoxDriver());
         ...

website_and_docs/content/documentation/test_practices/encouraged/fresh_browser_per_test.ja.md

@@ -15,6 +15,55 @@ aliases: [
 Firefoxの場合、既知のプロファイルでWebDriverを起動します。
 Most browser drivers like GeckoDriver and ChromeDriver will start with a clean
 known state with a new user profile, by default.
+
+```java
+// Using a class variable
+public abstract class BaseTest {
+	protected WebDriver driver;
+    ...
+
+    // Before each test hook
+    public void setupTest() {
+        driver = new FirefoxDriver();
+        ...
+    }
+
+    // After each test hook
+    public void teardownTest() {
+        ...
+        driver.quit();
+    }
+}
+```
+
+```python
+# Using python fixtures
+@pytest.fixture(autouse=True, scope='function')
+def driver(self, request, page: Page):
+    # Create the driver
+    driver = webdriver.Firefox()
+    
+    # Return control to the test 
+    yield self.driver
+
+    # Test ends driver quits
+    driver.quit()
+```
+
 ```java
-WebDriver driver = new FirefoxDriver();
+# Using a static variable
+
+# This forces the ThreadLocal<WebDriver> variable to call driver.get() every time the driver wants to be used.
+
+# In general static variables in non-thread safe code can have unintended consequences and increase the maintanance effort in the code base.
+
+public abstract class BaseTest {
+	protected ThreadLocal<WebDriver> driver;
+    ...
+    // Before each test hook
+    public void setupTest() {
+        BaseTest.driver = ThreadLocal.withInitial(()->new FirefoxDriver());
+        ...
+    }
+}
 ```

website_and_docs/content/documentation/test_practices/encouraged/fresh_browser_per_test.pt-br.md

@@ -15,5 +15,53 @@ pelo menos inicie um novo WebDriver para cada teste.
 Most browser drivers like GeckoDriver and ChromeDriver will start with a clean
 known state with a new user profile, by default.
 ```java
-WebDriver driver = new FirefoxDriver();
+// Using a class variable
+public abstract class BaseTest {
+	protected WebDriver driver;
+    ...
+
+    // Before each test hook
+    public void setupTest() {
+        driver = new FirefoxDriver();
+        ...
+    }
+
+    // After each test hook
+    public void teardownTest() {
+        ...
+        driver.quit();
+    }
+}
+```
+
+```python
+# Using python fixtures
+@pytest.fixture(autouse=True, scope='function')
+def driver(self, request, page: Page):
+    # Create the driver
+    driver = webdriver.Firefox()
+    
+    # Return control to the test 
+    yield self.driver
+
+    # Test ends driver quits
+    driver.quit()
+```
+
+```java
+# Using a static variable
+
+# This forces the ThreadLocal<WebDriver> variable to call driver.get() every time the driver wants to be used.
+
+# In general static variables in non-thread safe code can have unintended consequences and increase the maintanance effort in the code base.
+
+public abstract class BaseTest {
+	protected ThreadLocal<WebDriver> driver;
+    ...
+    // Before each test hook
+    public void setupTest() {
+        BaseTest.driver = ThreadLocal.withInitial(()->new FirefoxDriver());
+        ...
+    }
+}
 ```

website_and_docs/content/documentation/test_practices/encouraged/fresh_browser_per_test.zh-cn.md

@@ -15,5 +15,53 @@ aliases: [
 对于Firefox, 请使用您已知的配置文件去启动WebDriver.
 大多数浏览器驱动器，像GeckoDriver和ChromeDriver那样，默认都会以干净的已知状态和一个新的用户配置文件开始。
 ```java
-WebDriver driver = new FirefoxDriver();
+// Using a class variable
+public abstract class BaseTest {
+	protected WebDriver driver;
+    ...
+
+    // Before each test hook
+    public void setupTest() {
+        driver = new FirefoxDriver();
+        ...
+    }
+
+    // After each test hook
+    public void teardownTest() {
+        ...
+        driver.quit();
+    }
+}
+```
+
+```python
+# Using python fixtures
+@pytest.fixture(autouse=True, scope='function')
+def driver(self, request, page: Page):
+    # Create the driver
+    driver = webdriver.Firefox()
+    
+    # Return control to the test 
+    yield self.driver
+
+    # Test ends driver quits
+    driver.quit()
+```
+
+```java
+# Using a static variable
+
+# This forces the ThreadLocal<WebDriver> variable to call driver.get() every time the driver wants to be used.
+
+# In general static variables in non-thread safe code can have unintended consequences and increase the maintanance effort in the code base.
+
+public abstract class BaseTest {
+	protected ThreadLocal<WebDriver> driver;
+    ...
+    // Before each test hook
+    public void setupTest() {
+        BaseTest.driver = ThreadLocal.withInitial(()->new FirefoxDriver());
+        ...
+    }
+}
 ```