bazelbuild / bazelbuild/bazel

`native.bazel_version` is not documented

Open
#23,937 0 comments 4 reactions 0 assignees View on GitHub
P2 team-Documentation team-ExternalDeps type: bug
Dominant language
Java
Stars
25.8k
Forks
4.6k
Avg merge
2d 20h
Merged PRs (30d)
72

Description

### Description of the bug:

https://bazel.build/rules/lib/toplevel/native doesn't mention a field called `bazel_version`, but https://github.com/bazelbuild/bazel/blob/master/src/main/java/com/google/devtools/build/lib/packages/WorkspaceFactory.java#L360 populates it, and the `bazel_features` module [relies](https://github.com/bazel-contrib/bazel_features/blob/24b019d9385548c2daa9d329a466b66df5fde762/private/globals_repo.bzl#L22) on this API.

### Which category does this issue belong to?

_No response_

### What's the simplest, easiest way to reproduce this bug? Please provide a minimal example if possible.

_No response_

### Which operating system are you running Bazel on?

_No response_

### What is the output of `bazel info release`?

_No response_

### If `bazel info release` returns `development version` or `(@non-git)`, tell us how you built Bazel.

_No response_

### What's the output of `git remote get-url origin; git rev-parse HEAD` ?

_No response_

### If this is a regression, please try to identify the Bazel commit where the bug was introduced with bazelisk --bisect.

_No response_

### Have you found anything relevant by searching the web?

_No response_

### Any other information, logs, or outputs that you want to share?

_No response_

Contributor guide

Open the contributing guide

Research direction

Compare the native API documentation at bazel.build/rules/lib/toplevel/native with the bazel_version population in src/main/java/com/google/devtools/build/lib/packages/WorkspaceFactory.java and its use in globals_repo.bzl. Locate the source that generates the native documentation, document bazel_version there, and verify that the published API page includes it.

Written by the indexing model from the issue text.

Assessment

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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.