bazelbuild / bazelbuild/bazel

"Configurable Build Attributes" documentation is duplicated

Open
#25,669 1 comment 0 reactions 0 assignees View on GitHub
P2 team-Configurability team-Documentation type: documentation (cleanup)
Dominant language
Java
Stars
25.8k
Forks
4.6k
Avg merge
2d 20h
Merged PRs (30d)
72

Description

### Page link:

https://bazel.build/configure/attributes

### Problem description (include actual vs expected text, if applicable):

The documentation for Configurable Build Attributes is duplicated. Doc sources are located in both `site/en/configure/attributes.md` and `site/en/docs/configurable-attributes.md`.

As a consequence, @vorburger 96e29dc fix some line break in `site/en/docs/configurable-attributes.md` but those modifications do not reach [bazel website here](https://bazel.build/configure/attributes) because the source of truth for that page is actually `site/en/configure/attributes.md`.

### Where do you see this issue? (include link to specific section of the page, if applicable)

The discrepancy is located at this line:
> Matches must be unambiguous: if multiple conditions match then either

### Any other information you'd like to share?

_No response_

Contributor guide

Open the contributing guide

Research direction

Read site/en/configure/attributes.md and site/en/docs/configurable-attributes.md, then compare the duplicated Configurable Build Attributes content around the line about unambiguous matches. Determine which source generates the linked page, consolidate the documentation so there is one authoritative version, and verify the discrepancy is gone.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.