Tutorial is not a tutorial/ is too simple
- 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
Assessment
This issue has not been assessed yet.