ops: reduce comment density in PR #4433

Cut commentary from 104 to 24 lines across the new lint script, CI
config, and pre-push hook. Kept only: policy reference, why pattern is
loose, why scope is PR commits not history, and non-obvious CI behavior
notes. No logic lines changed.

Refs #4432
This commit is contained in:
atlas 2026-09-15 23:07:00 +02:00 committed by mara
commit 5bd68f9b8a
3 changed files with 19 additions and 99 deletions

View file

@ -1,17 +1,8 @@
#!/bin/sh
# Git pre-push hook: runs the tracker-tag, comment-block and doc-pointer
# lints against the working tree before any push lands on the remote.
# Catches issues that would fail CI and require a follow-up commit
# (common failure mode: a nix comment containing a hash-issue-number
# tag added mid-session).
# Install: ln -sf ../../scripts/pre-push .git/hooks/pre-push
#
# Install (once per clone):
# ln -sf ../../scripts/pre-push .git/hooks/pre-push
#
# The hook runs against the full working tree (not just staged or
# pushed files) to match what CI sees: `nix flake check` builds from
# the committed tree, so an untracked hit on a staged file would still
# trip CI.
# Runs against the full working tree (not just staged or pushed files) to match
# what CI sees: `nix flake check` builds from the committed tree.
set -eu
repo_root="$(git rev-parse --show-toplevel)"