Skip to content

getting-started.md example test cannot pass against any real target as written #43

Closed

Description

@shossain786

File: docs-site/docs/getting-started.md, Step 2's baseUrl: https://your-app.com combined with Step 3's Assert.assertTrue(getDriver().getTitle().contains("Dashboard")).

Nothing in the doc flags these values as placeholders that must be replaced before the test can run.

Repro

After fixing the missing execution.mode (separate issue), run the doc's example as-is.

Actual output

org.openqa.selenium.TimeoutException: timeout: Timed out receiving message from renderer: -0.006

against Command: [..., get {url=https://your-app.com}]. It retried 3 times total (retry.maxAttempts: 2 working as designed) before failing the build. Nothing in that output tells a new user "the URL is a placeholder, change it."

Confirmed the test passes once baseUrl is swapped for a real reachable page and the assertion updated to match that page's real title — the framework mechanics are fine, this is purely a docs-example problem.

Suggested fix

Either use a real, stable public demo page in the example, or add an explicit callout that baseUrl and the title assertion are placeholders requiring substitution.

Activity

  1. added a commit that references this issue on Sep 10, 2026
    840456c
  2. mdraza7544 commented on Sep 10, 2026

    @mdraza7544
    Contributor

    I have created a PR for this issue.
    The Getting Started example now uses a real and stable URL instead of a placeholder, so it can be run as written.
    PR: #44

  3. added a commit that references this issue on Sep 12, 2026
    37863a2
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationgood first issueGood for newcomers

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions