Skip to content

[SREP-4818] docs: add intructions to install with Homebrew#939

Open
gvnnn wants to merge 1 commit into
openshift:mainfrom
gvnnn:update-readme
Open

[SREP-4818] docs: add intructions to install with Homebrew#939
gvnnn wants to merge 1 commit into
openshift:mainfrom
gvnnn:update-readme

Conversation

@gvnnn
Copy link
Copy Markdown
Contributor

@gvnnn gvnnn commented May 12, 2026

What type of PR is this?

  • fix (Bug Fix)
  • feat (New Feature)
  • docs (Documentation)
  • test (Test Coverage)
  • chore (Clean Up / Maintenance Tasks)
  • other (Anything that doesn't fit the above)

What this PR does / Why we need it?

backplane-cli is now available within Homebrew, therefore instructions to install it should reflect that.

Which Jira/Github issue(s) does this PR fix?

Special notes for your reviewer

None.

Unit Test Coverage

Guidelines

  • If it's a new sub-command or new function to an existing sub-command, please cover at least 50% of the code
  • If it's a bug fix for an existing sub-command, please cover 70% of the code

Test coverage checks

  • Added unit tests
  • Created jira card to add unit test
  • This PR may not need unit tests

Pre-checks (if applicable)

  • Ran unit tests locally
  • Validated the changes in a cluster
  • Included documentation changes with PR
  • Backward compatible

/label tide/merge-method-squash

Summary by CodeRabbit

  • Documentation
    • Added macOS installation instructions using Homebrew
    • Reorganized installation method sections for improved clarity

@openshift-ci openshift-ci Bot added the tide/merge-method-squash Denotes a PR that should be squashed by tide when it merges. label May 12, 2026
@openshift-ci openshift-ci Bot requested review from diakovnec and xiaoyu74 May 12, 2026 07:49
@openshift-ci
Copy link
Copy Markdown
Contributor

openshift-ci Bot commented May 12, 2026

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: gvnnn
Once this PR has been reviewed and has the lgtm label, please assign typeid for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 12, 2026

Walkthrough

The PR updates the README.md installation documentation by adding a MacOS Homebrew installation option and restructuring subsection headings from "Option 1/Option 2" naming conventions to descriptive subsection titles.

Changes

Installation Documentation Improvements

Layer / File(s) Summary
MacOS installation and subsection reorganization
README.md
Added a new ### MacOS subsection with Homebrew installation instructions (brew install backplane-cli) under "Installation". Renamed the existing "Download from release" and "Build from source" subsections to use consistent ### heading format instead of numbered options.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

🚥 Pre-merge checks | ✅ 12
✅ Passed checks (12 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately reflects the main change: adding Homebrew installation instructions to the README documentation.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Stable And Deterministic Test Names ✅ Passed All Ginkgo test names are stable and deterministic. No dynamic content (fmt.Sprintf, variables, timestamps, IPs, pod names) found in test titles. Test names use descriptive static strings.
Test Structure And Quality ✅ Passed The custom check requires reviewing Ginkgo test code quality, but this PR only modifies README.md (documentation). No test files are changed, so the check is not applicable.
Microshift Test Compatibility ✅ Passed This PR is a documentation-only change (README.md). No new Ginkgo e2e tests (It, Describe, Context, When) were added. The MicroShift Test Compatibility check is not applicable.
Single Node Openshift (Sno) Test Compatibility ✅ Passed The SNO test compatibility check applies only to OpenShift e2e tests. This PR adds unit/integration tests for a CLI tool, not OpenShift e2e tests. Check is not applicable.
Topology-Aware Scheduling Compatibility ✅ Passed PR only modifies README.md documentation. No deployment manifests, operator code, or controllers are involved. Topology-aware scheduling check does not apply.
Ote Binary Stdout Contract ✅ Passed PR is documentation-only (README.md). OTE Binary Stdout Contract check applies to executable code changes. No code modified, so check not applicable.
Ipv6 And Disconnected Network Test Compatibility ✅ Passed The PR is a documentation-only change to README.md adding Homebrew installation instructions. No new Ginkgo e2e tests were added. The custom check only applies when new Ginkgo tests are introduced.

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

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

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.

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@README.md`:
- Around line 14-22: The README currently implies Go 1.19 is a global
prerequisite; restrict the Go prerequisite to source builds by moving or
duplicating the Go 1.19 requirement into the "Build from source" section and
removing it from top-level or MacOS install instructions (specifically update
the "MacOS" section and the global prerequisites so Homebrew install example for
backplane-cli doesn't imply Go is required); ensure the "Build from source"
heading explicitly lists "Go 1.19" and any build steps that require it so users
installing via Homebrew or downloads aren't misled.
- Line 14: Update the user-facing heading text that currently reads "MacOS" to
use the official product casing "macOS" in the README (change the heading line
with "### MacOS" to "### macOS") so documentation is consistent with product
naming.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository: openshift/coderabbit/.coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: 305a46af-7974-4b42-a50e-5d0041e8d4cf

📥 Commits

Reviewing files that changed from the base of the PR and between f742511 and 05169b9.

📒 Files selected for processing (1)
  • README.md

Comment thread README.md
Comment on lines +14 to 22
### MacOS

```brew
brew install backplane-cli
```


### Download from release

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Scope the Go prerequisite to source builds only.

With Homebrew install added, the global Go 1.19 prerequisite is misleading. Go is only required for “Build from source.”

Suggested fix
-Go should be installed in your local system with version 1.19 
+For building from source, Go should be installed locally (minimum version 1.19).
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@README.md` around lines 14 - 22, The README currently implies Go 1.19 is a
global prerequisite; restrict the Go prerequisite to source builds by moving or
duplicating the Go 1.19 requirement into the "Build from source" section and
removing it from top-level or MacOS install instructions (specifically update
the "MacOS" section and the global prerequisites so Homebrew install example for
backplane-cli doesn't imply Go is required); ensure the "Build from source"
heading explicitly lists "Go 1.19" and any build steps that require it so users
installing via Homebrew or downloads aren't misled.

Comment thread README.md
Go should be installed in your local system with version 1.19

### Option 1: Download from release
### MacOS
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Use official product casing: macOS.

MacOS should be macOS for user-facing documentation consistency.

Suggested fix
-### MacOS
+### macOS
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
### MacOS
### macOS
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@README.md` at line 14, Update the user-facing heading text that currently
reads "MacOS" to use the official product casing "macOS" in the README (change
the heading line with "### MacOS" to "### macOS") so documentation is consistent
with product naming.

@openshift-ci
Copy link
Copy Markdown
Contributor

openshift-ci Bot commented May 12, 2026

@gvnnn: The following test failed, say /retest to rerun all failed tests or /retest-required to rerun all mandatory failed tests:

Test name Commit Details Required Rerun command
ci/prow/test 05169b9 link true /test test

Full PR test history. Your PR dashboard.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

@codecov-commenter
Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 53.99%. Comparing base (f742511) to head (05169b9).

Additional details and impacted files

Impacted file tree graph

@@            Coverage Diff             @@
##             main     #939      +/-   ##
==========================================
- Coverage   54.02%   53.99%   -0.04%     
==========================================
  Files          82       82              
  Lines        6323     6323              
==========================================
- Hits         3416     3414       -2     
- Misses       2462     2463       +1     
- Partials      445      446       +1     

see 1 file with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

tide/merge-method-squash Denotes a PR that should be squashed by tide when it merges.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants