Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Steps for installing Bazelisk are not new-developer friendly #571

Open
armandomontanez opened this issue Apr 16, 2024 · 1 comment
Open
Labels
P3 We're not considering working on this, but happy to review a PR. (No assignee) type: feature request New feature or request

Comments

@armandomontanez
Copy link

The current instructions for installing Bazelisk are not user-friendly.

Generally, the widely expected ways to get a tool on the following platforms are:

  • Windows: Download an .exe installer that guides users through installation.
  • macOS: Download .deb or .pkg that guides users through installation.
  • Linux: apt get install bazelisk or similar through a preferred package manager.

Today, the instructions are:

  • Windows: choco install bazelisk
  • macOS: brew install bazelisk
  • Linux: There's essentially a decision tree here.

Often, when I direct people to install Bazel via https://bazel.build/install, they end up directly using a release of Bazel rather than Bazelisk. I know the reason I've done this in the past is because of the lack of clarity in the installation process for Bazelisk.

  • On macOS, I don't use brew (I've had it corrupt frequently for various reasons, so I now avoid it entirely).
  • On Windows, I've never once used or installed choco despite doing a decent amount of development on Windows.
  • On Linux, I know how to take a binary and add it to PATH, but I know for a fact that someone just getting started with development would stumble over that.

Generally speaking, the recommended flows for installing Bazelisk are atypical at best, and frustrating at worst. Bazelisk should strive to make the installation experience as frictionless as possible to ensure Bazel is approachable for new developers.

@jwnimmer-tri
Copy link
Contributor

As a step in the right direction, I think attaching Debian binary packages to the https://github.com/bazelbuild/bazelisk/releases page would be a nice start. I opened a PR for that at #563.

@meteorcloudy meteorcloudy added type: feature request New feature or request P3 We're not considering working on this, but happy to review a PR. (No assignee) labels Apr 23, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
P3 We're not considering working on this, but happy to review a PR. (No assignee) type: feature request New feature or request
Projects
None yet
Development

No branches or pull requests

3 participants