At the moment, we have this documentation: https://docs.bazel.build/versions/0.28.0/be/common-definitions.html#common-attributes I think it's an important topic, it should be explained in a separate section (not in the attribute documentation). Things to mention: - Why visibility is important (especially as a code base grows) - Discourage public visibility - Visibility of rule dependencies (https://github.com/bazelbuild/bazel/issues/7377) - Visibility of files, with and without exports_files (https://github.com/bazelbuild/bazel/issues/2835) - Visibility of bzl files
Activity
Move documentation of 'visibility' to a separate page
Simplify visibility docs
Add mention of package_group's own visibility