Skip to content

docs(ci): experimental cross-browser testing (twd-runner) section#288

Merged
kevinccbsg merged 1 commit into
mainfrom
docs/twd-runner-experimental
Jun 29, 2026
Merged

docs(ci): experimental cross-browser testing (twd-runner) section#288
kevinccbsg merged 1 commit into
mainfrom
docs/twd-runner-experimental

Conversation

@kevinccbsg

Copy link
Copy Markdown
Member

Adds a contained experimental section to the CI Execution page documenting twd-runner for cross-browser (Firefox/WebKit) testing.

Deliberately low-key, per the framing we want:

  • Not a top-level nav/sidebar entry — it lives at the end of ci-execution.md so it's discoverable but not advertised.
  • Opens with an Experimental warning and states clearly that twd-cli is the recommended runner and covers ~90% of use cases.
  • Positions twd-runner as a complement (Firefox/WebKit), not a replacement — no coverage/contracts, slower, single-job-parallel so it stays CI-agnostic.
  • Recommends the split: full suite on Chromium via twd-cli, cross-browser pass via twd-runner (browsers: ["firefox","webkit"]).

npm run docs:build passes.

Document twd-runner as an experimental complement to twd-cli for Firefox/WebKit
coverage, embedded in the CI Execution page rather than a top-level nav entry.
Frames twd-cli as the recommended runner that covers ~90% of use cases;
twd-runner is a nice-to-have cross-browser pass (no coverage/contracts, slower).
@kevinccbsg kevinccbsg merged commit 3db4d68 into main Jun 29, 2026
9 checks passed
@kevinccbsg kevinccbsg deleted the docs/twd-runner-experimental branch June 29, 2026 10:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant