bazelbuild/bazel

Refocus installation instructions on Bazelisk

Open

#10.348 aberto em 2 de dez. de 2019

Ver no GitHub
 (1 comment) (0 reactions) (0 assignees)Java (4.465 forks)batch import
P3help wantedteam-Documentationteam-OSStype: documentation (cleanup)

Métricas do repositório

Stars
 (25.384 stars)
Métricas de merge de PR
 (Mesclagem média 22d 20h) (77 fundiu PRs em 30d)

Description

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.

Guia do colaborador

Direção de pesquisa
Revise o guia de instalação atual no URL fornecido e entenda como instalar o Bazel diretamente. Em seguida, pesquise o Bazelisk e determine como atualizar as instruções de instalação para recomendar o Bazelisk como método principal. Escreva a documentação atualizada.
Pilha de tecnologia
None
Domain
tooling
Tipo Issue
Documentação
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
2
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
1-3 horas
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Antigo
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Claro
Prerequisites
Git
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
85