summaryrefslogtreecommitdiffstats
path: root/CLAUDE.md
diff options
context:
space:
mode:
Diffstat (limited to 'CLAUDE.md')
-rw-r--r--CLAUDE.md8
1 files changed, 8 insertions, 0 deletions
diff --git a/CLAUDE.md b/CLAUDE.md
index e576326..1f837eb 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -185,6 +185,14 @@ These are about working on the tree rather than about the design:
installed package where its own migrations are, which is right for a
package, a venv and a checkout alike
+- **A `DEBIAN/control` file has no comment syntax.** `dpkg-deb --build` refuses
+ the whole package — `field name '#' must be followed by colon` — so a `#` line
+ explaining why a dependency is weak turns an installable package into no
+ package at all. The `.spec` files take comments and the control files do not;
+ the reason for a `Recommends` goes in `packaging/README.md`. Found by building
+ a throwaway package, which takes seconds and is the only way to find it: no
+ test in the tree parses these files
+
- **`node --check` reports success on a module-syntax error, and a green one
cost a full suite run.** An unclosed `.map(` inside a tagged template came
back clean four times in a row. `test_spa_syntax.py` says this in its own