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 · 4 comments
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
@eabase
Copy link

eabase commented May 25, 2024

I totally agree. Trying to use this for the very first time I find the instructions lacking.
There is no way I'm gonna install choco (or scoop) when I can just run the stand-alone release installer or use winget.

At the end of the day, I still fail to see why this is needed. Long text there, but not very to the point. What is the problem Bazel, that this is trying to solve? (A use case scenario would have been enlightening.)

Then also for building, you are not saying anything on the requirements of having WiX and the unknown Make-MSI package, used in here:

@SpartanJoe193
Copy link

Absolutely. I've gotten interest in a program called QuarkGL, which I have been trying to compile Bazelisk for

@bingjeff
Copy link

+1. I actually stumbled onto this thread, because I wasn't sure this was "the right way", surely I was missing something? Nope.

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

6 participants