Add readme justifying why existence of playgrounds

Author: dprevost-LMI

playgrounds/jasmine/README.md

@@ -0,0 +1,16 @@
+# Jasmine Playground
+
+This is a playground for E2E testing with the `@wdio/jasmine-framework` to ensure compatibility with `expect-webdriverio`.
+
+## Features and Limitations
+
+*   **Soft Assertions**: `SoftAssertionService` is not supported, as Jasmine provides similar behavior natively.
+*   **Snapshots**: Basic snapshot testing currently does not work well.
+*   **Visual Snapshots**: The `@wdio/visual-service` does not work properly due to a lack of compatible hooks in Jasmine.
+*   **Options Configuration**: Global configurations (like `setOptions({ wait: 500 })`) are fully supported.
+*   **Asymmetric Matchers**: Native Jasmine asymmetric matchers (like `jasmine.any()`) are properly supported.
+
+## Test Structure
+
+*   `test/specs/expect-wdioImport/`: Tests using the direct import of `expect-webdriverio` (Jest-based).
+*   `test/specs/globalImport/`: Tests using the global import, which pulls the Jasmine `expect` by default.

playgrounds/jasmine/package-lock.json

@@ -0,0 +1,15 @@
+# Jest Playground
+
+This is a playground for E2E testing with Jest, ensuring the compatibility of `expect-webdriverio` and primarily serving to test Jest augmentation.
+
+## Notes and Limitations
+
+*   **Framework**: There is no official WebdriverIO framework for Jest (e.g., no `@wdio/jest-framework`).
+*   **Matcher Registration**: WebdriverIO custom matchers need to be manually registered via Jest augmentation to work with Jest's global `expect`.
+*   **Snapshots**: Basic snapshot testing can work fine, but it may conflict with Jest's native snapshot mechanism.
+*   **Visual Snapshots**: Visual snapshot testing works successfully.
+
+## Test Structure
+
+*   `test/`: Tests demonstrating integration with Jest using global matcher augmentation.
+*   **TODO**: Add a `test/expect-wdioImport` folder showing how to use `expect-webdriverio` by importing it directly as a standalone module without global Jest augmentation.

playgrounds/jest/README.md

@@ -1,6 +1,15 @@
-# expect-webdriverio Playground - Mocha
+# Mocha Playground
 
-This playground project uses the local build of expect-webdriverio with WebDriverIO and Mocha framework.
+This playground project uses the local build of `expect-webdriverio` with WebDriverIO and the Mocha framework. It serves as the default, out-of-the-box experience where all features are fully supported and work easily.
+
+## Features and Support
+
+Because Mocha is the standard framework for `expect-webdriverio`, all features work natively without conflicts:
+
+*   **Soft Assertions**: Fully supported using the `SoftAssertionService` plugin in the `wdio.conf.ts` services.
+*   **Snapshots**: Basic text/data snapshot testing works seamlessly.
+*   **Visual Snapshots**: Visual snapshot testing directly integrates via `@wdio/visual-service`.
+*   **Global Options Configuration**: Easily set global wait times and other configurations (e.g., `setOptions({ wait: 250 })` in the `before` hook).
 
 ## Setup
 
@@ -21,9 +30,10 @@ This playground project uses the local build of expect-webdriverio with WebDrive
 
 ## Structure
 
-- `test/specs/` - E2E test files
-- `wdio.conf.ts` - WebDriverIO configuration with Mocha
-- Uses local build from `../../lib/index.js`
+- `test/specs/` - E2E test files covering various feature sets (basic matchers, soft expectations, snapshots, visual comparisons).
+- `wdio.conf.ts` - WebDriverIO configuration demonstrating how to wire up the `SoftAssertionService`, the Visual service, and global `expect-webdriverio` options.
+- `visual-snapshot/` - Directory for storing and comparing visual screenshot baselines and temp images.
+- Uses local build from `/expect-webdriverio/lib/index.js`.
 
 ## Tests