bazelbuild/bazel

[bazel.build] Problem with /start/cpp

Open

#28670 opened on Feb 14, 2026

View on GitHub
 (0 comments) (0 reactions) (0 assignees)Java (25,384 stars) (4,465 forks)batch import
P2help wantedteam-Documentationteam-OSSteam-Rules-CPPtype: documentation (cleanup)

Description

Page link:

https://bazel.build/start/cpp

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

The BUILD file on the page doesn't match what's in the GitHub repository for the examples.

This caused me to get errors when I tried to set up my own project and didn't understand that you needed to have load() in there. The errors I saw did tell me about load, but I wasn't sure why I needed it, when the example on the page didn't include it.

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

https://bazel.build/start/cpp#understand-build https://github.com/bazelbuild/examples/blob/main/cpp-tutorial/stage1/main/BUILD

Any other information you'd like to share?

No response

Contributor guide

Tech stack
None
Domain
documentationbuild system
Issue type
documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
1
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
under 1 hour
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
Basic knowledge of Bazel BUILD files
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
90
Research direction
Compare the BUILD file snippet at https://bazel.build/start/cpp#understand build with the actual file in the examples repository (https://github.com/bazelbuild/examples/blob/main/cpp tutorial/stage1/main/BUILD). Update the documentation to include necessary load() statements or ensure consistency. The fix is localized to the documentation file for the start/cpp page.