bazelbuild/bazel

Refocus installation instructions on Bazelisk

Open

#10.348 geöffnet am 2. Dez. 2019

Auf GitHub ansehen
 (1 Kommentar) (0 Reaktionen) (0 zugewiesene Personen)Java (4.465 Forks)batch import
P3help wantedteam-Documentationteam-OSStype: documentation (cleanup)

Repository-Metriken

Stars
 (25.384 Stars)
PR-Merge-Metriken
 (Durchschn. Merge 22T 20h) (77 gemergte PRs in 30 T)

Beschreibung

I’ve noticed that the installation guide is focused on installing Bazel directly into a system. However, it seems like Bazelisk is a preferred way of managing Bazel versions, like the Gradle wrapper is. Shouldn’t we refocus the documentation on using Bazelisk instead, omitting direct Bazel installation guides? I think it might push users into the right direction. I can be completely wrong about this however since I’m very new to the scene. I can work on it if it makes sense.

Contributor Guide

Research-Richtung
Überprüfen Sie die aktuelle Installationsanleitung unter der angegebenen URL und verstehen Sie, wie Bazel direkt installiert wird. Recherchieren Sie dann Bazelisk und bestimmen Sie, wie die Installationsanweisungen aktualisiert werden, um Bazelisk als primäre Methode zu empfehlen. Schreiben Sie die aktualisierte Dokumentation.
Tech Stack
Keine
Domain
tooling
Issue Type
Dokumentation
SchwierigkeitGeschätzte Implementierungsschwierigkeit für neue Contributors, von 1 für sehr kleine Änderungen bis 5 für Expertenarbeit.
2
Geschätzte ZeitEin grober Zeitrahmen, um zu recherchieren, zu implementieren, zu testen und einen Pull Request vorzubereiten.
1-3 Stunden
AktivitätsstatusWie verfügbar das Issue gerade wirkt: frisch, aktiv, stale, blockiert oder wartet auf Maintainer-Input.
Veraltet
KlarheitWie klar das Issue die erwartete Änderung, Akzeptanzkriterien und den nächsten Schritt erklärt.
Klar
Voraussetzungen
Git
EinsteigerfreundlichkeitEin Score von 1 bis 100, der schätzt, wie zugänglich dieses Issue für First-Time Contributors ist.
85