The design documents published here are part of a design process:
It's possible that designs change as they are implemented in practice. The design documents published here capture the initial design, and not the ongoing changes as designs are implemented.
Always go to the documentation for descriptions of current Bazel functionality.
Changes to the Bazel build and extension language (Skylark) should go through the Skylark Design Process.