.gitattributes

# Generated files.
#
# `linguist-generated=true` does two things on GitHub: the file is collapsed by
# default in a pull request's diff, and it is left out of the language
# statistics. Neither changes what git stores — these files are tracked, and
# `scripts/gen-dashboards.py --check` still fails when one is out of date.
#
# WHY THIS MATTERS HERE. The dashboards refactor is 156 files and 100,060
# insertions, of which 84,247 are generated JSON: one dashboard.json per board,
# the chart copies of each, and the two install bundles. A reviewer opening
# that diff meets eighty thousand lines of machine-written JSON before reaching
# any of the 15,813 lines a person wrote, and the natural conclusion is that
# the change cannot be reviewed. It can; the JSON is derived from
# dashboards/<board>/board.py and is proved to match it by a gate.
#
# Every path below is one scripts/gen-dashboards.py writes, and that script's
# --check mode verifies the two lists agree — so a new generated file that is
# not marked here fails the build rather than quietly reappearing in the diff.
#
# Read board.py, not dashboard.json. The JSON is output.

# The canonical board, one per directory under dashboards/.
dashboards/*/dashboard.json                 linguist-generated=true

# The install bundles: the provisioning tree and the kubectl-apply-able
# ConfigMap set, both generated from the same boards.
dashboards/bundle/**                        linguist-generated=true

# The chart copies. Each is byte-identical to a board or one of its variants.
charts/monitoring/dashboards/*.json         linguist-generated=true

# Vendored upstream chart dependencies, unpacked by `helm dependency build`.
# Not ours to review either.
charts/*/charts/**                          linguist-generated=true