Clarify where repository rules should be defined #8941
Labels
help wanted
Someone outside the Bazel team could own this
P3
We're not considering working on this, but happy to review a PR. (No assignee)
team-Documentation
Documentation improvements that cannot be directly linked to other team labels
team-ExternalDeps
External dependency handling, remote repositiories, WORKSPACE file.
type: documentation (cleanup)
Description of the feature request:
Add wording in the Bazel rule deployment guidelines clarifying where repository rules should be defined:
defs.bzl
,repositories.bzl
or elsewhere?Feature requests: what underlying problem are you trying to solve with this feature?
Currently, the documentation says "rules" should be exposed in
defs.bzl
. There is a section titled "Repository rules", which one would expect says what to do about repository rules, but it only discusses introducing a single macro that defines all necessary dependencies. If I have a set of rules calledrules_foo
, which perhaps has a few build rules and several repository rules, it's unclear where the user should expect to find all the repository rules.The text was updated successfully, but these errors were encountered: