Skip to content

docs: update testing-your-application.md for WheelsTest#2128

Merged
bpamiri merged 1 commit intodevelopfrom
peter/rename-testbox-in-testing-guide
Apr 16, 2026
Merged

docs: update testing-your-application.md for WheelsTest#2128
bpamiri merged 1 commit intodevelopfrom
peter/rename-testbox-in-testing-guide

Conversation

@bpamiri
Copy link
Copy Markdown
Collaborator

@bpamiri bpamiri commented Apr 16, 2026

Summary

Editorial follow-up to #2127 (sweep PR) covering the largest user-facing testing doc: docs/src/working-with-wheels/testing-your-application.md (39 refs).

Applies the same three-bucket rubric from #2126/#2127, plus fixes stale code paths to match the actual tests/runner.cfm implementation. Deferred from the sweep because it needed per-line editorial judgment.

Changes

Stale code paths corrected (per tests/runner.cfm:99-246):

  • testbox.system.TestBoxwheels.wheelstest.system.TestBox
  • testbox.system.reports.JSONReporterwheels.wheelstest.system.reports.JSONReporter
  • testbox.system.reports.TextReporterwheels.wheelstest.system.reports.TextReporter
  • testbox.system.reports.ANTJUnitReporterwheels.wheelstest.system.reports.ANTJUnitReporter

Framework-identity references renamed:

  • TestBox 6WheelsTest (drops upstream version qualifier)
  • Section headings: "TestBox Features", "TestBox Test Runner Configuration", "TestBox testing URLs", JSON output section
  • Comments: // load testbox routes// load wheelstest routes
  • Migration section: "Legacy RocketUnit to TestBox" → "to WheelsTest"

Upstream URL references reframed (URLs kept, provenance clarified):

  • "official TestBox documentation" → "upstream TestBox documentation"
  • Each testbox.ortusbooks.com link labeled with "upstream" and where appropriate "(WheelsTest preserves the same API)"

Intro paragraph rewritten to establish provenance:

WheelsTest — Wheels' in-house testing framework (a fork of Ortus TestBox). WheelsTest replaces the legacy RocketUnit framework…

Legitimate retentions (10 refs)

Per the rubric's bucket 3:

  • 1 fork-explanation ("a fork of Ortus TestBox")
  • 8 upstream URL labels pointing to testbox.ortusbooks.com
  • 1 code variable name testBox = new wheels.wheelstest.system.TestBox(...) — matches actual runner.cfm convention

Test plan

  • Code paths cross-checked against tests/runner.cfm (namespace is wheels.wheelstest.system.*, function setTestboxEnvironment() kept as-is since that's the actual function name)
  • All 10 remaining TestBox refs are in the "legitimate retention" bucket (upstream URL labels + fork explanation + canonical variable name)
  • Migration section maintains history while pointing users at WheelsTest going forward
  • Manual review of intro paragraph tone — currently "a fork of Ortus TestBox" which acknowledges provenance without burying the lead

Remaining editorial follow-up (separate PR)

Still deferred per the sweep plan:

  • cli/WHEELS-CLI-ROADMAP.md (15 refs)
  • examples/tweet/.claude/commands/wheels_execute.md (10 refs) + .opencode/command/wheels_execute.md (11 refs)

🤖 Generated with Claude Code

Editorial follow-up to #2127. Updates the main user-facing testing
guide for the WheelsTest rename, plus fixes stale code paths to
match the actual tests/runner.cfm implementation.

Scope (39 refs → 10 legitimate retentions):

Stale code paths corrected to match tests/runner.cfm:99-246:
  - testbox.system.TestBox → wheels.wheelstest.system.TestBox
  - testbox.system.reports.JSONReporter → wheels.wheelstest...
  - testbox.system.reports.TextReporter → wheels.wheelstest...
  - testbox.system.reports.ANTJUnitReporter → wheels.wheelstest...

Framework-identity references renamed:
  - TestBox 6 → WheelsTest (drops upstream version qualifier)
  - "TestBox Features" heading → "WheelsTest Features"
  - "TestBox Test Runner Configuration" → "WheelsTest Test Runner
    Configuration"
  - "TestBox testing URLs" → "WheelsTest URLs"
  - JSON-output section renamed to reference WheelsTest runner
  - `// load testbox routes` comment → `// load wheelstest routes`
  - Migration section: "Legacy RocketUnit to TestBox" → "to WheelsTest"

Upstream URL references reframed (keeping URLs, clarifying provenance):
  - "official TestBox documentation" → "upstream TestBox documentation"
  - Each ortusbooks.com link labeled with "upstream" and where
    appropriate "(WheelsTest preserves the same API)"

Intro paragraph rewritten to establish provenance: "WheelsTest —
Wheels' in-house testing framework (a fork of Ortus TestBox)".

Legitimate retentions (10):
  - 1 fork-explanation reference (intro)
  - 8 upstream URL labels pointing to testbox.ortusbooks.com
  - 1 code variable name `testBox = new wheels.wheelstest.system.
    TestBox(...)` — matches actual runner.cfm convention

Preserved historical references:
  - Sections describing pre-Wheels-3.0 RocketUnit legacy
  - "Wheels 3.0" framing where specifically describing the 3.0 release

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@github-actions github-actions bot added the docs label Apr 16, 2026
bpamiri added a commit that referenced this pull request Apr 16, 2026
Editorial follow-up PR to #2127 and #2128. Covers the last three files
deferred from the sweep:

WHEELS-CLI-ROADMAP.md (cli/):
  Added a status banner at the top of the document noting that the
  testing-strategy sections predate the WheelsTest fork decision. The
  roadmap originally proposed integrating the external commandbox-
  testbox-cli module; the actual direction was to fork TestBox in-house
  as WheelsTest. Rather than rewriting the strategy sections (out of
  scope for rename), the banner makes the historical context clear and
  flags for a separate editorial pass.

  References preserved as-is for historical traceability:
    - Section 4 "Advanced Testing (via TestBox CLI Module)"
    - Leverage Existing Modules item 1
    - Phase 1 Module Integration
    - CommandBox Integration Points
    - box.json dependency listing for commandbox-testbox-cli
    - Recommended Module Installation section

examples/tweet/.claude/commands/wheels_execute.md (10 refs):
  - TestBox BDD → WheelsTest BDD (descriptive references)
  - testbox.system.TestBox → wheels.wheelstest.system.TestBox (code)
  - application.testbox → application.wheelstest (CFML scope)
  - "Use TestBox's beforeEach/afterEach" → "Use WheelsTest's …"

examples/tweet/.opencode/command/wheels_execute.md (11 refs):
  Same treatment as the .claude/commands variant — this is the mirror
  opencode command file.

Closes the TestBox → WheelsTest rename initiative across all forward-
looking doc files. Only historical references, upstream URL labels,
and the roadmap's preserved strategy sections remain.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@bpamiri bpamiri merged commit 3dc2d78 into develop Apr 16, 2026
5 checks passed
@bpamiri bpamiri deleted the peter/rename-testbox-in-testing-guide branch April 16, 2026 21:07
bpamiri added a commit that referenced this pull request Apr 16, 2026
)

Editorial follow-up PR to #2127 and #2128. Covers the last three files
deferred from the sweep:

WHEELS-CLI-ROADMAP.md (cli/):
  Added a status banner at the top of the document noting that the
  testing-strategy sections predate the WheelsTest fork decision. The
  roadmap originally proposed integrating the external commandbox-
  testbox-cli module; the actual direction was to fork TestBox in-house
  as WheelsTest. Rather than rewriting the strategy sections (out of
  scope for rename), the banner makes the historical context clear and
  flags for a separate editorial pass.

  References preserved as-is for historical traceability:
    - Section 4 "Advanced Testing (via TestBox CLI Module)"
    - Leverage Existing Modules item 1
    - Phase 1 Module Integration
    - CommandBox Integration Points
    - box.json dependency listing for commandbox-testbox-cli
    - Recommended Module Installation section

examples/tweet/.claude/commands/wheels_execute.md (10 refs):
  - TestBox BDD → WheelsTest BDD (descriptive references)
  - testbox.system.TestBox → wheels.wheelstest.system.TestBox (code)
  - application.testbox → application.wheelstest (CFML scope)
  - "Use TestBox's beforeEach/afterEach" → "Use WheelsTest's …"

examples/tweet/.opencode/command/wheels_execute.md (11 refs):
  Same treatment as the .claude/commands variant — this is the mirror
  opencode command file.

Closes the TestBox → WheelsTest rename initiative across all forward-
looking doc files. Only historical references, upstream URL labels,
and the roadmap's preserved strategy sections remain.

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant