bazelbuild / bazelbuild/bazel

Tutorial is not a tutorial/ is too simple

Open
#15,579 1 comment 0 reactions 1 assignee Claimed by @jdob View on GitHub
P2 team-Documentation team-Rules-CPP type: feature request
Dominant language
Java
Stars
25.8k
Forks
4.6k
Avg merge
2d 18h
Merged PRs (30d)
75

Description

https://bazel.build/tutorials/cpp can be reduced to two steps:

1. Check out a github repo
2. Run a command.

The tutorial starts with

In this tutorial you learn how to:

Build a target
Visualize the project's dependencies
Split the project into multiple targets and packages
Control target visibility across packages
Reference targets through labels

However it arguably only teaches the first two. The next three are just check out code in which this is already done. The reader does not learn how to do these tasks themselves. The web page adds nothing to the sample code.

What's needed is a more codelab like tutorial that has the reader create their own WORKSPACE and BUILD files from a blank screen piece by piece. It's useful to give completed answers in the repo, but this is not enough by itself.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.