bazelbuild/bazel

build docs on configuration need an update

Open

#15,067 opened on Mar 17, 2022

View on GitHub
 (0 comments) (0 reactions) (0 assignees)Java (4,465 forks)batch import
P3help wantedteam-Configurabilityteam-Documentationtype: documentation (cleanup)

Repository metrics

Stars
 (25,384 stars)
PR merge metrics
 (Avg merge 22d 20h) (77 merged PRs in 30d)

Description

https://bazel.build/docs/build#build-config-cross-compilation talks about the target configuration and host configuration. It should be updated to discuss the exec configuration and perhaps also the role of toolchains. --distinct_host_configuration should not be mentioned, since it is moribund.

Contributor guide

Research direction
Review the current documentation page at https://bazel.build/docs/build#build config cross compilation and update it to replace references to 'target configuration' and 'host configuration' with 'exec configuration', remove mentions of distinct host configuration, and add clarification about toolchains.
Tech stack
java
Domain
documentationtooling
Issue type
Documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
1
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
Under 1 hour
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
GitMarkdown
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
85