Update the documentation

Author: mdmintz

README.md

@@ -18,9 +18,9 @@
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/seleniumbase/console_scripts/ReadMe.md">🔮 Scripts</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/mobile_testing.md">📱 Phone</a>
 <br />
-<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/method_summary.md">📙 APIs</a> |
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/method_summary.md">📚 APIs</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/syntax_formats.md">📝 Formats</a> |
-<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/example_logs/ReadMe.md">🔵 Dashboard</a> |
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/example_logs/ReadMe.md">⚪ Dashboard</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/recorder_mode.md">🔴 Recorder</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/locale_codes.md">🗾 Locales</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/seleniumbase/utilities/selenium_grid/ReadMe.md">🌐 Grid</a>
@@ -32,11 +32,18 @@
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/chart_maker/ReadMe.md">📊 Charts</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/tour_examples/ReadMe.md">🚎 Tours</a>
 <br />
-<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/integrations/github/workflows/ReadMe.md">🤖 CI</a> |
-<a href="https://github.com/seleniumbase/SeleniumBase/tree/master/examples/boilerplates">♻️ Boilerplates</a> |
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/how_it_works.md">👁️ How</a> |
+<a href="https://github.com/seleniumbase/SeleniumBase/tree/master/examples/migration/raw_selenium">🚝 Migrate</a> |
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/case_plans.md">📒 CasePlans</a> |
+<a href="https://github.com/seleniumbase/SeleniumBase/tree/master/integrations/node_js">🚉 NodeGUI</a> |
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/master_qa/ReadMe.md">🧬 Hybrid</a> |
+<a href="https://seleniumbase.io/devices/?url=seleniumbase.com">💻 Farm</a>
+<br />
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/integrations/github/workflows/ReadMe.md">🤖 CI/CD</a> |
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/js_package_manager.md">🕹️ JSMgr</a> |
+<a href="https://github.com/seleniumbase/SeleniumBase/tree/master/examples/boilerplates">♻️ Templates</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/html_inspector.md">🔎 Inspector</a> |
-<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/js_package_manager.md">🕹️ JSCode</a> |
-<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/dialog_boxes/ReadMe.md">🛂 Dialogs</a> |
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/dialog_boxes/ReadMe.md">🛂 Boxes</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/visual_testing/ReadMe.md">🖼️ Visual</a>
 <br />
 </p>
@@ -200,6 +207,7 @@ COMMANDS:
       behave-options   (List common behave options)
       gui / commander  [OPTIONAL PATH or TEST FILE]
       behave-gui       (SBase Commander for Behave)
+      caseplans        [OPTIONAL PATH or TEST FILE]
       mkdir            [DIRECTORY] [OPTIONS]
       mkfile           [FILE.py] [OPTIONS]
       mkrec / codegen  [FILE.py] [OPTIONS]

help_docs/features_list.md

@@ -8,6 +8,7 @@
 * A powerful Python framework for browser automation and E2E UI testing.
 * Includes [Recorder Mode](https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/recorder_mode.md) for instantly generating browser tests in Python.
 * Supports multiple browsers, tabs, iframes, and proxies in the same test.
+* Includes [Test Case Management Software](https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/case_plans.md) with Markdown technology.
 * Automatic smart-waiting improves reliability and prevents flaky tests.
 * Supports [pytest](https://docs.pytest.org/en/latest/), [unittest](https://docs.python.org/3/library/unittest.html), [nose](http://nose.readthedocs.io/en/latest/), and [behave](https://behave.readthedocs.io/en/stable/index.html) for finding/running tests.
 * All the code is open source. Look inside to learn about any feature.

help_docs/how_it_works.md

@@ -38,7 +38,17 @@ class TestMFALogin(BaseCase):
         self.assert_exact_text("You have been signed out!", "#top_message")
 ```
 
-(See the example test, [my_first_test.py](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/my_first_test.py), for reference.)
+(See the example, [test_mfa_login.py](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_mfa_login.py), for reference.)
+
+The most common way of running SeleniumBase tests is with ``pytest``:
+
+```bash
+pytest --headless --rs --dashboard --html=report.html -v -n=4
+pytest test_mfa_login.py
+pytest -m marker2
+pytest offline_examples/
+pytest -k agent
+```
 
 --------
 

help_docs/html_inspector.md

@@ -22,13 +22,13 @@ pytest test_inspect_html.py
 ============== test session starts ==============
 
 * HTML Inspection Results: https://xkcd.com/1144/
-X - 'property' is not a valid attribute of the <meta> element.
-X - Do not use <div> or <span> elements without any attributes.
-X - The 'alt' attribute is required for <img> elements.
-X - The 'border' attribute is no longer valid on the <img> element and should not be used.
-X - 'srcset' is not a valid attribute of the <img> element.
-X - The <center> element is obsolete and should not be used.
-X - <script> elements should appear right before the closing </body> tag for optimal performance.
-X - The id 'comicLinks' appears more than once in the document.
+⚠️  'property' is not a valid attribute of the <meta> element.
+⚠️  Do not use <div> or <span> elements without any attributes.
+⚠️  The 'alt' attribute is required for <img> elements.
+⚠️  The 'border' attribute is no longer valid on the <img> element and should not be used.
+⚠️  'srcset' is not a valid attribute of the <img> element.
+⚠️  The <center> element is obsolete and should not be used.
+⚠️  <script> elements should appear right before the closing </body> tag for optimal performance.
+⚠️  The id 'comicLinks' appears more than once in the document.
 * (See the Console output for details!)
 ```