Skip to content

Document osb shorthand command#1013

Open
drtootsie wants to merge 1 commit into
opensearch-project:mainfrom
drtootsie:add-osb-shorthand-docs
Open

Document osb shorthand command#1013
drtootsie wants to merge 1 commit into
opensearch-project:mainfrom
drtootsie:add-osb-shorthand-docs

Conversation

@drtootsie
Copy link
Copy Markdown

Addresses #744

Changes

Add documentation for the osb shorthand command that can be used as an alias for opensearch-benchmark.

Documentation Added

  • Example showing both full and shorthand commands
  • Updated help command reference to include osb --help

Example

# Full command
opensearch-benchmark execute-test --workload=geonames

# Shorthand equivalent
osb execute-test --workload=geonames

This makes it easier and faster for users to invoke OpenSearch Benchmark.

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Feb 15, 2026

Important

Review skipped

Auto incremental reviews are disabled on this repository.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
📝 Walkthrough

Walkthrough

Updated README.md to document the shorthand command "osb" for opensearch-benchmark. Added a new "Shorthand Command" section in Quick Start with usage examples and updated the Quick Help reference to include both the full and shorthand command syntax.

Changes

Cohort / File(s) Summary
Documentation
README.md
Added "Shorthand Command" section in Quick Start demonstrating osb as shorthand for opensearch-benchmark, including code examples. Updated Quick Help reference to mention both full and shorthand command availability.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

🚥 Pre-merge checks | ✅ 4
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and accurately summarizes the main change: documenting the osb shorthand command in the README.
Description check ✅ Passed The description is directly related to the changeset, providing clear context about documenting the osb shorthand command and referencing the related issue.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Merge Conflict Detection ✅ Passed ✅ No merge conflicts detected when merging into main

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@drtootsie drtootsie force-pushed the add-osb-shorthand-docs branch 2 times, most recently from b8cac2d to 3dbfac8 Compare February 15, 2026 20:24
Comment thread README.md

```bash
# Full command
opensearch-benchmark execute-test --workload=geonames
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In OSB 2.0, we replaced execute-test and test-execution with run and test-run respectively. Can you just update execute-test to run here?

@OVI3D0
Copy link
Copy Markdown
Member

OVI3D0 commented Feb 16, 2026

thanks @drtootsie ! Just left one comment :)

Addresses opensearch-project#744

Add documentation for the 'osb' shorthand command that can be used
as an alias for 'opensearch-benchmark', making it easier and faster
to invoke the tool.

Signed-off-by: drtootsie <peptz7@gmail.com>
@drtootsie drtootsie force-pushed the add-osb-shorthand-docs branch from 3dbfac8 to 9327d09 Compare March 10, 2026 04:10
@github-actions
Copy link
Copy Markdown

PR Reviewer Guide 🔍

Here are some key observations to aid the review process:

🧪 No relevant tests
🔒 No security concerns identified
✅ No TODO sections
🔀 No multiple PR themes
⚡ Recommended focus areas for review

Numbering Gap

After adding step 5, the next item jumps to step 6, which may indicate a missing step or a numbering inconsistency in the release checklist. Verify that no step was accidentally skipped between the original step 5 and the new step 5.

5. Run `opensearch-benchmark list workloads` (or `osb list workloads`)
6. Run a basic workload on Linux and MacOS:  `opensearch-benchmark run --workload pmc --test-mode`

Comment thread README.md
opensearch-benchmark execute-test --workload=geonames

# Shorthand equivalent
osb execute-test --workload=geonames
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

hey @drtootsie , looks like this line and line 41 still say execute-test :p

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.

2 participants