bazelbuild / bazelbuild/bazel

repository_rule#local incorrect documentation

Open
#28,497 0 comments 0 reactions 0 assignees View on GitHub
help wanted P3 team-Documentation team-ExternalDeps 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/rules/lib/globals/bzl.html#repository_rule

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

> Indicate that this rule fetches everything from the local system and should be reevaluated at every fetch.

This is not true. See #16217 for why it is expected behavior that the rule is not always re-evaluated.

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

https://bazel.build/rules/lib/globals/bzl.html#repository_rule

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

This argument might just be a complete misfeature. If so, it should be documented as such.

Contributor guide

Open the contributing guide

Research direction

Start at the repository_rule documentation page linked in the issue and read the referenced issue #16217 for the expected reevaluation behavior. Update the misleading text about fetching from the local system and reevaluation, with the completed page accurately reflecting the documented behavior or clearly identifying the argument as a misfeature if that is confirmed.

Written by the indexing model from the issue text.

Assessment

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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.