Commit a6f567f
authored
docs(policy): retiring a flake means its references too (#566)
§2.1 already rules Nix retired and rightly warns against mass-deletion.
The owner ruling of 2026-07-28 — *"nix flakes are deprecated and to be
thrown from the estate"* — is **reconciled with that warning rather than
overriding it**: removal stays a per-repo judgement made while you are
*already working in the repo*. Opportunistic, never a fan-out sweep.
## What was genuinely missing
**Deleting `flake.nix` does not retire Nix.** Measured on
`trope-checker`
([#47](hyperpolymath/trope-checker#47)), one
flake had **ten satellites**:
| file | what it kept alive |
|---|---|
| `.envrc` | a direnv `use flake` block |
| `Justfile` + `contractiles/Justfile` | a `nix-shell` recipe |
| `build/setup.sh` | `nix` in package-manager detection **and** the
install switch |
| `install-tools.sh` | a flake-detecting branch running **ahead of
Guix** |
| `.github/dependabot.yml` | a `nix` `package-ecosystem` entry |
| `.gitignore` / `.gitattributes` | `flake.lock` and `*.nix` rules |
| `compliance/reuse/dep5` | `flake.lock` in the lockfile glob |
| docs / `PLAYBOOK.a2ml` | prose |
Leave any behind and the toolchain still reaches for Nix. They're now
listed in §2.1.
## Two traps recorded, because both cost time
- **`dependabot.yml` rejects the whole file on one malformed entry** —
re-parse after removing the `nix` ecosystem.
- **A root `.githooks/` is usually load-bearing** (CI runs validators
straight from it) — allowlist it in `root-allow.txt`; don't "tidy" it
away in passing.
Plus the standing caveat, restated where it will be read: a repo whose
`guix.scm` is a scaffold stub has **no working packaging** once the
flake is gone. Make Guix real, or fill the sealed container, *in the
same change*.
## Flagged, not resolved — the canon disagrees with itself
This repo carries **two** `LANGUAGE-POLICY.adoc` files and they
contradict each other:
- **`./LANGUAGE-POLICY.adoc`** (this one) self-declares canonical, is
the more current — §2.2 records the squisher-corpus identity clobber
measured 2026-07-29 across 418 repos — and makes **Bun tier 1**.
- **`./rhodium-standard-repositories/spec/LANGUAGE-POLICY.adoc`** still
lists **Deno** as *"Replaces Node/npm/Bun"*.
PR #51 on trope-checker cites the first; the estate `CLAUDE.md` I was
working under states the second. **I have not resolved this** — it needs
an owner decision on which file is authoritative. Note the Nix hardening
was also added to the *other* file earlier (standards #557), so both now
carry it; the runtime-tier contradiction is untouched.
Renders clean under `asciidoctor`.
🤖 Generated with [Claude Code](https://claude.com/claude-code)1 parent 56c2e5c commit a6f567f
1 file changed
Lines changed: 29 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
77 | 77 | | |
78 | 78 | | |
79 | 79 | | |
| 80 | + | |
| 81 | + | |
| 82 | + | |
| 83 | + | |
| 84 | + | |
| 85 | + | |
| 86 | + | |
| 87 | + | |
| 88 | + | |
| 89 | + | |
| 90 | + | |
| 91 | + | |
| 92 | + | |
| 93 | + | |
| 94 | + | |
| 95 | + | |
| 96 | + | |
| 97 | + | |
| 98 | + | |
| 99 | + | |
| 100 | + | |
| 101 | + | |
| 102 | + | |
| 103 | + | |
| 104 | + | |
| 105 | + | |
| 106 | + | |
| 107 | + | |
| 108 | + | |
80 | 109 | | |
81 | 110 | | |
82 | 111 | | |
| |||
0 commit comments