Skip to content

[bazel.build] Problem with /external/overview #25269

Open
@goretkin

Description

Page link:

https://bazel.build/external/overview

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

https://bazel.build/external/overview#main-repository says

The repository in which the current Bazel command is being run.

The root of the main repository is also known as the workspace root.

but it seems it should not say anything about the Bazel commands running within. The "context" in which Bazel commands run is the "workspace" not the "repository". Note this is the opposite direction of conflation as what is documented. This is "repository" being used to mean "workspace", but the conflation (quoted below) is the opposite direction.

https://bazel.build/external/overview also says

Workspace

The environment shared by all Bazel commands run in the same main repository. It encompasses the main repo and the set of all defined external repos.

Note that historically the concepts of "repository" and "workspace" have been conflated; the term "workspace" has often been used to refer to the main repository, and sometimes even used as a synonym of "repository".

and https://bazel.build/concepts/build-ref#workspace says

A workspace is the environment shared by all Bazel commands run from the same main repo. It encompasses the main repo and the set of all defined external repos.

Note that historically the concepts of "repository" and "workspace" have been conflated; the term "workspace" has often been used to refer to the main repository, and sometimes even used as a synonym of "repository".

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

No response

Any other information you'd like to share?

No response

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions