Update documentation

Author: mdmintz

examples/behave_bdd/ReadMe.md

@@ -16,17 +16,17 @@ Feature: SeleniumBase scenarios for the RealWorld App # features/realworld.featu
 
   Scenario: Verify RealWorld App (log in / sign out)  # features/realworld.feature:3
     Given Open "seleniumbase.io/realworld/login"      # ../../sbase/steps.py:10
-    And Clear Session Storage                         # ../../sbase/steps.py:391
-    When Type "demo_user" into "#username"            # ../../sbase/steps.py:28
-    And Type "secret_pass" into "#password"           # ../../sbase/steps.py:28
-    And Do MFA "GAXG2MTEOR3DMMDG" into "#totpcode"    # ../../sbase/steps.py:194
-    Then Assert exact text "Welcome!" in "h1"         # ../../sbase/steps.py:85
-    And Highlight "img#image1"                        # ../../sbase/steps.py:95
-    And Click 'a:contains("This Page")'               # ../../sbase/steps.py:19
-    And Save screenshot to logs                       # ../../sbase/steps.py:120
-    When Click link "Sign out"                        # ../../sbase/steps.py:104
-    Then Assert element 'a:contains("Sign in")'       # ../../sbase/steps.py:60
-    And Assert text "You have been signed out!"       # ../../sbase/steps.py:77
+    And Clear Session Storage                         # ../../sbase/steps.py:613
+    When Type "demo_user" into "#username"            # ../../sbase/steps.py:40
+    And Type "secret_pass" into "#password"           # ../../sbase/steps.py:40
+    And Do MFA "GAXG2MTEOR3DMMDG" into "#totpcode"    # ../../sbase/steps.py:309
+    Then Assert exact text "Welcome!" in "h1"         # ../../sbase/steps.py:157
+    And Highlight "img#image1"                        # ../../sbase/steps.py:171
+    And Click 'a:contains("This Page")'               # ../../sbase/steps.py:27
+    And Save screenshot to logs                       # ../../sbase/steps.py:226
+    When Click link "Sign out"                        # ../../sbase/steps.py:182
+    Then Assert element 'a:contains("Sign in")'       # ../../sbase/steps.py:120
+    And Assert text "You have been signed out!"       # ../../sbase/steps.py:145
    ✅ Scenario Passed!
 
 - Dashboard: /Users/michael/github/SeleniumBase/examples/behave_bdd/dashboard.html

help_docs/customizing_test_runs.md

@@ -277,12 +277,34 @@ The code above will leave your browser window open in case there's a failure. (p
 🎛️ There are times when you'll want to combine various command-line options for added effect.
 For instance, the multi-process option, ``-n8``, can be customized by adding:
 ``--dist=loadscope`` or ``--dist=loadfile`` to it.
-Here's more info on that, as taken from [pytest-xdist](https://pypi.org/project/pytest-xdist/):
+There's more info on that here: [pytest-xdist](https://pypi.org/project/pytest-xdist/2.5.0/):
 
 * ``-n8 --dist=loadscope``: Tests are grouped by module for test functions and by class for test methods. Groups are distributed to available workers as whole units. This guarantees that all tests in a group run in the same process. This can be useful if you have expensive module-level or class-level fixtures. Grouping by class takes priority over grouping by module.
 
 * ``-n8 --dist=loadfile``: Tests are grouped by their containing file. Groups are distributed to available workers as whole units. This guarantees that all tests in a file run in the same worker.
 
+<details>
+<summary> ▶️ <code>-n8 --dist=loadgroup</code> (<b>click to expand</b>)</summary>
+<div>
+
+* Tests are grouped by the ``xdist_group`` mark. Groups are distributed to available workers as whole units. This guarantees that all tests with same ``xdist_group`` name run in the same worker.
+
+```python
+@pytest.mark.xdist_group(name="group1")
+def test_1():
+    pass
+
+class Test:
+    @pytest.mark.xdist_group("group1")
+    def test_2():
+        pass
+```
+
+> This makes ``test_1`` and ``Test::test_2`` run in the same worker. Tests without the ``xdist_group`` mark are distributed normally.
+
+</div>
+</details>
+
 🎛️ You might also want to combine multiple options at once. For example:
 
 ```bash

help_docs/how_it_works.md

@@ -46,7 +46,7 @@ class TestMFALogin(BaseCase):
 👁️🔎 Here are some examples of running tests with ``pytest``:
 
 ```bash
-pytest --headless --rs --dashboard --html=report.html -v -n=4
+pytest --headless -n8 --dashboard --html=report.html -v --rs --crumbs
 pytest test_mfa_login.py
 pytest -m marker2
 pytest offline_examples/

integrations/behave/ReadMe.md

@@ -13,15 +13,18 @@ Dashboard: /Users/michael/github/SeleniumBase/examples/behave_bdd/dashboard.html
 Feature: SeleniumBase scenarios for the RealWorld App # features/realworld.feature:1
 
   Scenario: Verify RealWorld App (log in / sign out)  # features/realworld.feature:3
-    Given Open the RealWorld Login Page               # steps/real_world.py:4
-    When Login to the RealWorld App                   # steps/real_world.py:11
-    Then Assert exact text "Welcome!" in "h1"         # steps/real_world.py:89
-    When Highlight element "img#image1"               # steps/real_world.py:19
-    And Click element 'a:contains("This Page")'       # steps/real_world.py:29
-    Then Save a screenshot to the logs                # steps/real_world.py:49
-    When Click link "Sign out"                        # steps/real_world.py:39
-    Then Assert element 'a:contains("Sign in")'       # steps/real_world.py:55
-    And Assert text "You have been signed out!"       # steps/real_world.py:79
+    Given Open "seleniumbase.io/realworld/login"      # ../../sbase/steps.py:10
+    And Clear Session Storage                         # ../../sbase/steps.py:613
+    When Type "demo_user" into "#username"            # ../../sbase/steps.py:40
+    And Type "secret_pass" into "#password"           # ../../sbase/steps.py:40
+    And Do MFA "GAXG2MTEOR3DMMDG" into "#totpcode"    # ../../sbase/steps.py:309
+    Then Assert exact text "Welcome!" in "h1"         # ../../sbase/steps.py:157
+    And Highlight "img#image1"                        # ../../sbase/steps.py:171
+    And Click 'a:contains("This Page")'               # ../../sbase/steps.py:27
+    And Save screenshot to logs                       # ../../sbase/steps.py:226
+    When Click link "Sign out"                        # ../../sbase/steps.py:182
+    Then Assert element 'a:contains("Sign in")'       # ../../sbase/steps.py:120
+    And Assert text "You have been signed out!"       # ../../sbase/steps.py:145
    ✅ Scenario Passed!
 
 - Dashboard: /Users/michael/github/SeleniumBase/examples/behave_bdd/dashboard.html