Practical Learning Kit overview (v1.1.0)

The Practical Learning Kit is a business-driven build path for WebSureQTool. Each lesson exists to prove a real business outcome, not just to demonstrate a feature. You build the suites yourself by following the lesson — that teaches the product better than receiving prebuilt files.

How to use the kit

1. Create the project, suite, and dataset before authoring steps.
- Suggested project name: WSQ-SauceDemo-LearningKit
- Create your own dataset file, for example data/default.csv, and add the keys each lesson asks for (USERNAME, PASSWORD, PRODUCTS_TITLE, FIRSTNAME, LASTNAME, ZIP, etc.).

2. Open the target application in the browser.
- Use the full URL, including the protocol (https://www.saucedemo.com/).
- Confirm Edge or Chrome and the matching WebDriver path.

3. Scan the current page.
- Click Scan to load all UI elements from the live browser into the upper grid.
- Pick elements in the same order the business flow runs (username, password, login button).

4. Edit each picked activity.
- Inputs: action = type, valueMode = dataset, dataset key (for example USERNAME, PASSWORD).
- Buttons: action = click.
- Verifications: action = none plus an assertion (text-equals, visible, url-contains, exists).
- Captures: capture_* action plus a Save As name.

5. START is automatic. Keep one terminal END at the bottom.

6. Run early, then extend.
- After the first 2-3 steps, click Run.
- Catch selector or dataset mistakes before the suite gets long.

7. Add manual steps where scanned elements are not enough.
- wait, end, URL assertions, captures, branches, loops, labels, and jumps are added manually.

8. Multi-page authoring rule.
- Scan each page after navigating to it. Steps belong to the page where they were authored.

9. Refresh scanned elements when the page state changes.
- After login, sort, add-to-cart, or checkout, click Scan again before picking new elements.

The 13 lessons

- LK01: Valid login reaches the Products page.
- LK02: Invalid login is blocked clearly (regex on error message).
- LK03: Catalog sort applies correctly (select + attr-contains).
- LK04: Cart badge updates after add and remove.
- LK05: Shopper completes checkout successfully (full happy path).
- LK06: Login session is preserved for next suite.
- LK07: Continue from the preserved session and finish checkout.
- LK08: Empty cart routes to a recovery path (branch + label + jump).
- LK09: Repeat sort block safely and exit (loop with bound).
- LK10: Store runtime values and reuse them as evidence.
- LK11: Capture URL, title, and browser storage (capture-first / assert-separately).
- LK12: Cart count satisfies grouped business data rules (exists, not-null, is-int, range).
- LK13: Golden capability demonstration (combines everything).

Asking the Intelligent Assistant
- For step-by-step authoring help on any lesson, ask: "walk me through LK05" or "how do I build LK11 in the Suite Editor".
- For troubleshooting any lesson, ask: "LK08 branch goes to the wrong path" or "LK07 fails because no session".

The public guide stays intentionally high level. Open the Intelligent Assistant for click-by-click instructions, learning order, and practice ideas.