Skip to content

docs: rename TestBox to WheelsTest in 4.0 release docs#2126

Merged
bpamiri merged 1 commit intodevelopfrom
peter/rename-testbox-to-wheelstest
Apr 16, 2026
Merged

docs: rename TestBox to WheelsTest in 4.0 release docs#2126
bpamiri merged 1 commit intodevelopfrom
peter/rename-testbox-to-wheelstest

Conversation

@bpamiri
Copy link
Copy Markdown
Collaborator

@bpamiri bpamiri commented Apr 16, 2026

Summary

Follow-up to #2123 (audit) and #2124 (CHANGELOG catch-up), which both merged while inline rename edits were being prepared. Applies a targeted three-bucket rename rubric to the content those two PRs added.

Why: Wheels consumed TestBox to drive its own destiny and call it WheelsTest. Forward-looking references in the 4.0 release docs should use WheelsTest; historical / rename-event references stay as-is for provenance.

The three-bucket rubric

Bucket Example Treatment
Current framework identity "TestBox test suite" Rename → WheelsTest test suite
BDD style/pattern name "TestBox BDD is required" Drop qualifier → BDD syntax (via WheelsTest)
Historical / event references "testbox → wheelstest namespace rename" (describes the rename); "WireBox/TestBox replaced" (describes replacement); 3.0 dep mentions Preserved — factual history

Edits (6 lines across 2 files)

CHANGELOG.md — 3 forward-looking edits

  • L88: TestBox test suiteWheelsTest test suite
  • L109: **Breaking:** TestBox test base class namespace renamed → drops "TestBox" (redundant with the sentence that follows)
  • L123: TestBox BDD is requiredBDD syntax (via WheelsTest) is required

docs/releases/wheels-4.0-audit.md — 3 forward-looking edits

  • L118: TestBox BDD is the only supported styleWheelsTest (BDD syntax) is the only supported style
  • L137: TestBox test suite for the moduleWheelsTest test suite for the module
  • L236: TestBox BDD is mandatoryWheelsTest (BDD syntax) is mandatory

Historical references deliberately preserved

  • CHANGELOG.md:114 — "WireBox/TestBox replaced" (describes the replacement event)
  • CHANGELOG.md:237 — 3.0.0 dep section "Updated WireBox (^7.0.0) and TestBox (^6.0.0) requirements" (factual history)
  • audit:116 — "testbox → wheelstest namespace rename" (describes the rename itself)
  • audit:205 — "WireBox replaced + TestBox replaced" (rim modernization event)
  • audit:292 — "WireBox/TestBox replacement" (blog theme context mentioning the event)

Matches the same principle the CHANGELOG uses at lines 11-17 for CFWheels references: "All historical references... have been preserved for accuracy."

Test plan

Follow-up

  • Repo-wide sweep covering ~30 other files (docs/src/, CLAUDE.md, tests/README.md, examples, .ai/wheels/testing/, etc.) using the same rubric — planned as a separate PR so reviewers can see the sweep as one cohesive rename.

🤖 Generated with Claude Code

Follow-up to #2123 (audit) and #2124 (CHANGELOG catch-up), which
merged before inline rename edits could land. Applies the same
three-bucket rename rubric to the just-merged content:

  1. Current framework identity → rename to WheelsTest
  2. BDD style name → drop TestBox qualifier (just "BDD syntax")
  3. Historical / rename-event references → preserved as-is (factual)

6 targeted edits:
  - CHANGELOG.md line 88:  TestBox test suite → WheelsTest test suite
  - CHANGELOG.md line 109: Breaking prefix drops "TestBox" (redundant)
  - CHANGELOG.md line 123: TestBox BDD → BDD syntax (via WheelsTest)
  - audit line 118: TestBox BDD is → WheelsTest (BDD syntax) is
  - audit line 137: TestBox test suite → WheelsTest test suite
  - audit line 236: TestBox BDD is mandatory → WheelsTest (BDD syntax)

Preserved as historical / rename-event references (unchanged):
  - CHANGELOG.md line 114: "WireBox/TestBox replaced"
  - CHANGELOG.md line 237: 3.0 dep "TestBox (^6.0.0) requirements"
  - audit line 116: "testbox → wheelstest namespace rename" (the event)
  - audit line 205: "WireBox replaced + TestBox replaced" (the event)
  - audit line 292: "WireBox/TestBox replacement" (blog theme context)

Follow-up: a broader repo-wide sweep covering ~30 other files
(docs/src/, CLAUDE.md, tests/README, examples, .ai/wheels/testing/)
will apply the same rubric in a separate PR.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@github-actions github-actions bot added the docs label Apr 16, 2026
@bpamiri bpamiri merged commit d21df05 into develop Apr 16, 2026
3 checks passed
@bpamiri bpamiri deleted the peter/rename-testbox-to-wheelstest branch April 16, 2026 20:13
bpamiri added a commit that referenced this pull request Apr 16, 2026
Repo-wide sweep applying the three-bucket rename rubric to 20 forward-
looking documentation files. Companion to #2125 (comparison doc) and
#2126 (audit + CHANGELOG follow-up).

Rubric applied:
  1. Current framework identity → rename to WheelsTest
  2. BDD style/pattern name → drop TestBox qualifier, use "BDD syntax"
  3. Historical / rename-event / upstream-project references → preserved

Files updated (20 total):
  - docs/wheels-vs-frameworks.md
  - CLAUDE.md, CONTRIBUTING.md
  - docs/src/working-with-wheels/{directory-structure,end-to-end-testing,
    browser-testing}.md
  - docs/src/command-line-tools/cli-guides/testing.md
  - tests/README.md
  - .ai/wheels/testing/{browser-testing,unit-testing}.md
  - .ai/wheels/{views,controllers,models}/testing.md
  - examples/{README,starter-app/README,tweet/AGENTS}.md
  - examples/tweet/.claude/skills/{README,SKILLS-QUICK-START}.md
  - packages/{legacyadapter/README,sentry/CLAUDE}.md

Legitimate retentions (per rubric bucket 3):
  - "formerly TestBox" history notes in CONTRIBUTING.md
  - Upstream URL labels pointing to testbox.ortusbooks.com
    (framed as "Upstream TestBox Docs" for BDD syntax reference)
  - this.testbox CFML Application.cfc property (back-compat convention)
  - /tmp/testbox_results.json temp-file names in shell examples

CLI command updates where code paths exist:
  - `box testbox run` → `wheels test run` in tests/README.md and
    examples/starter-app/README.md (matches Wheels CLI canonical form
    per CLAUDE.md's testing quick reference)

Upstream reference reframing in .ai/wheels/{views,controllers,models}/
testing.md: "Modern TestBox Resources" section retitled to "BDD Reference
— Upstream TestBox Docs" with explicit note that WheelsTest inherits the
BDD syntax from upstream Ortus TestBox.

Deferred to editorial follow-up PRs (complex mix of stale code,
CommandBox commands, URLs, and prose requiring verification):
  - docs/src/working-with-wheels/testing-your-application.md (39 refs)
  - cli/WHEELS-CLI-ROADMAP.md (15 refs)
  - examples/tweet/.{claude/commands,opencode/command}/wheels_execute.md

Out of scope (historical planning artifacts, per rubric bucket 3):
  - docs/superpowers/plans/**
  - docs/superpowers/specs/**

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
bpamiri added a commit that referenced this pull request Apr 16, 2026
Repo-wide sweep applying the three-bucket rename rubric to 20 forward-
looking documentation files. Companion to #2125 (comparison doc) and
#2126 (audit + CHANGELOG follow-up).

Rubric applied:
  1. Current framework identity → rename to WheelsTest
  2. BDD style/pattern name → drop TestBox qualifier, use "BDD syntax"
  3. Historical / rename-event / upstream-project references → preserved

Files updated (20 total):
  - docs/wheels-vs-frameworks.md
  - CLAUDE.md, CONTRIBUTING.md
  - docs/src/working-with-wheels/{directory-structure,end-to-end-testing,
    browser-testing}.md
  - docs/src/command-line-tools/cli-guides/testing.md
  - tests/README.md
  - .ai/wheels/testing/{browser-testing,unit-testing}.md
  - .ai/wheels/{views,controllers,models}/testing.md
  - examples/{README,starter-app/README,tweet/AGENTS}.md
  - examples/tweet/.claude/skills/{README,SKILLS-QUICK-START}.md
  - packages/{legacyadapter/README,sentry/CLAUDE}.md

Legitimate retentions (per rubric bucket 3):
  - "formerly TestBox" history notes in CONTRIBUTING.md
  - Upstream URL labels pointing to testbox.ortusbooks.com
    (framed as "Upstream TestBox Docs" for BDD syntax reference)
  - this.testbox CFML Application.cfc property (back-compat convention)
  - /tmp/testbox_results.json temp-file names in shell examples

CLI command updates where code paths exist:
  - `box testbox run` → `wheels test run` in tests/README.md and
    examples/starter-app/README.md (matches Wheels CLI canonical form
    per CLAUDE.md's testing quick reference)

Upstream reference reframing in .ai/wheels/{views,controllers,models}/
testing.md: "Modern TestBox Resources" section retitled to "BDD Reference
— Upstream TestBox Docs" with explicit note that WheelsTest inherits the
BDD syntax from upstream Ortus TestBox.

Deferred to editorial follow-up PRs (complex mix of stale code,
CommandBox commands, URLs, and prose requiring verification):
  - docs/src/working-with-wheels/testing-your-application.md (39 refs)
  - cli/WHEELS-CLI-ROADMAP.md (15 refs)
  - examples/tweet/.{claude/commands,opencode/command}/wheels_execute.md

Out of scope (historical planning artifacts, per rubric bucket 3):
  - docs/superpowers/plans/**
  - docs/superpowers/specs/**

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