bazelbuild/bazel

Documentation reference shard_count heuristics

Open

#14.446 aberto em 19 de dez. de 2021

Ver no GitHub
 (0 comments) (0 reactions) (0 assignees)Java (4.465 forks)batch import
P3help wantedteam-Documentationtype: 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

The documentation for shard_count says:

This value will override any heuristics used to determine the number of parallel shards with which to run the test. Note that for some test rules, this parameter may be required to enable sharding in the first place. Also see --test_sharding_strategy.

But the docs also say the only permitted values for --test_sharding_strategy are explicit and disabled. In other words, Bazel never shards a test that doesn't specify shard_count.

The reference to heuristics appears to be vestigial (or future?).

Guia do colaborador

Direção de pesquisa
Reveja a documentação do Bazel para 'shard count' em https://docs.bazel.build/versions/main/be/common definitions.html#common attributes tests e a flag ' test sharding strategy' em https://docs.bazel.build/versions/main/command line reference.html#flag test sharding strategy. O problema afirma que a referência a heurísticas está incorreta; atualize a documentação para esclarecer que shard count é obrigatório para o sharding e remova a menção a heurísticas.
Pilha de tecnologia
java
Domain
build system
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.
Menos de 1 hora
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Ativo
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Claro
Prerequisites
None
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
90