Skip to content

[GEN-1903] Add docs to https://github.com/qawolf/docs for new APIs#136

Draft
Joonil Kim (bartholomaeuskim) wants to merge 3 commits into
mainfrom
gen-1903-add-docs-to-httpsgithubcomqawolfdocs-for-new-apis
Draft

[GEN-1903] Add docs to https://github.com/qawolf/docs for new APIs#136
Joonil Kim (bartholomaeuskim) wants to merge 3 commits into
mainfrom
gen-1903-add-docs-to-httpsgithubcomqawolfdocs-for-new-apis

Conversation

@bartholomaeuskim
Copy link
Copy Markdown

Overview of Problem

Per GEN-1903 — the expect references in the flows API docs still describe the pre-GEN-1885 "type-safe stub" world. After the GEN-1885/GEN-1884/GEN-1907 chain lands, expect is the real assertion library on every entry point, and the troubleshooting page contains a stub-error section that can no longer fire.

Overview of Changes

Five edits across four files refresh the references to match the post-unification surface:

  • android.mdx / ios.mdx: expect section now points at expect-webdriverio matchers and cross-links to the native screenshot guide for toHaveScreenshot.
  • cli.mdx: expect section now points at the expect package (Jest matchers) with a more realistic toMatchObject example.
  • web.mdx: new expect section pointing at Playwright's expect with auto-retrying locator matchers and a cross-link to the web screenshot guide.
  • troubleshooting.mdx: deletes the `expect` Throws A Stub Error section (stub can no longer fire after GEN-1885); drops expect from the "Runtime API Called Outside The Flow Callback" cause list (expect is now safe at module level).

Blocked by qawolf/platform#26255 (GEN-1907) — the mobile toHaveScreenshot cross-links assume the unified mobile matcher is available. Mark ready once that lands.

@mintlify
Copy link
Copy Markdown

mintlify Bot commented May 26, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
qawolf 🟢 Ready View Preview May 26, 2026, 12:29 AM

expect is the real implementation post-unification (GEN-1885/1884/1907)
and can be referenced at module level; only its matcher calls need the
running flow. Mirrors the troubleshooting.mdx update. Addresses Jon's ask
to refresh references with old examples.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant