mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2026-11-10 04:36:40 +00:00
3529 invalid comments in 528 files, grandfathered in while the linter only saw the working-tree diff. Removal ran through the linter's own collectors, so detection and deletion cannot drift: a comment whose opener line is blank before it and whose closer line is blank after it loses all its lines, anything else loses only the comment region, and a line left holding a bare delimiter goes with it. Five files keep their comments behind a nocheck marker instead. Four are upstream configs whose inline docs are upstream's own (mautrix, systemd journald, nextcloud-oidc-login, MediaWiki). In littlejs the commented-out entries ARE the deactivation mechanism for an example tile, so deleting them would delete configuration. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Python Lint 🐍
Python-specific code conventions: unittest import shape, PROJECT_ROOT usage, ban on raw os.walk/Path.rglob/uncached read_text, noqa marker hygiene, redundant boolean patterns, and self-path-reference avoidance.
Tests in this directory MUST only cover Python source patterns. Dependency declarations MUST live under dependencies/; YAML/Jinja patterns MUST live under yaml/.
For framework and make test-lint usage see lint.md.