Skip to content

feat(sphinxdocs): support documenting flag scope in bzl:flag - #4488

Merged
rickeylev merged 1 commit into
bazel-contrib:mainfrom
rickeylev:sphinx_flag_scope_docs
Nov 13, 2026
Merged

rickeylev merged 1 commit into
bazel-contrib:mainfrom
rickeylev:sphinx_flag_scope_docs

Conversation

@rickeylev

Copy link
Copy Markdown
Collaborator

Bazel Starlark build flags can configure a scope (such as universal
or project), which determines how flag values propagate across
configurations, but {bzl:flag} had no way to record it.

Add a :scope: option to {bzl:flag} that renders a Scope: field at
the top of the flag description, and document :scope: universal on
universal flags in //python/config_settings.

Bazel Starlark build flags can configure a `scope` (such as `universal`
or `project`), which determines how flag values propagate across
configurations, but `{bzl:flag}` had no way to record it.

Add a `:scope:` option to `{bzl:flag}` that renders a `Scope:` field at
the top of the flag description, and document `:scope: universal` on
universal flags in `//python/config_settings`.
@rickeylev
rickeylev requested a review from aignas as a code owner November 13, 2026 08:12
@rickeylev

Copy link
Copy Markdown
Collaborator Author

This pull request was authored with AI agent assistance. No agent
autonomously replies to review comments on this PR; the human author
reviews all feedback directly and approves any responses or follow-up
changes before they are posted.

This is an automatically generated agent comment.

@rickeylev
rickeylev enabled auto-merge November 13, 2026 08:20
@rickeylev
rickeylev merged commit 4e76096 into bazel-contrib:main Nov 13, 2026
15 checks passed
@rickeylev
rickeylev deleted the sphinx_flag_scope_docs branch November 13, 2026 17:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant