Skip to content

docs(project-overview): benchmarks are a subcommand, not a flag - #1228

Merged
Chemaclass merged 1 commit into
mainfrom
docs/1227-benchmark-command
Aug 14, 2026
Merged

docs(project-overview): benchmarks are a subcommand, not a flag#1228
Chemaclass merged 1 commit into
mainfrom
docs/1227-benchmark-command

Conversation

@Chemaclass

Copy link
Copy Markdown
Member

🤔 Background

Related #1227

The project overview — the page that orients new contributors — told them to run benchmarks with ./bashunit -s -b tests and ./bashunit --simple --bench tests. Both are rejected as unknown options, and git log -S finds no sign either was ever a flag. Benchmarks are the bashunit bench [path] subcommand.

The regular-test commands two lines above are correct, which is what made the broken pair easy to miss.

💡 Changes

  • Use the subcommand form in both the Quick and Complete tabs, verified against the real tests/ path
  • Add one line saying benchmarks are a subcommand rather than a flag on the test run

The Running tests block told new contributors to use `-s -b` and
`--simple --bench`. Neither exists -- both are rejected as unknown options, and
`git log -S` finds no sign either was ever a flag. Benchmarks are
`bashunit bench [path]`, which --help advertises.

The regular-test commands two lines above are correct, which is what made the
broken pair easy to miss.

Closes #1227
@Chemaclass Chemaclass added the documentation Improvements or additions to documentation label Aug 14, 2026
@Chemaclass Chemaclass self-assigned this Aug 14, 2026
@Chemaclass
Chemaclass merged commit 2b7e3d3 into main Aug 14, 2026
6 checks passed
@Chemaclass
Chemaclass deleted the docs/1227-benchmark-command branch August 14, 2026 08:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant