Skip to content

Release / freshness checklist

Operational checklist for ongoing freshness (Phase 5.1 cadence). Run on each cadence trigger below so release facts, experimental flags, CLI stamps, mesh/Clan notes, and evaluator maturity do not rot.

This is a meta process doc, not a subject article. Pair with research-method.md when rewriting leaves and quality-checklist.md when reaffirming complete.

Triggers (when to run)

Trigger Primary focus
Each NixOS release Experimental hub; release cadence; installer/download/channel cites
Each major Nix release CLI cheatsheet; feature flags; modern CLI leaves; store/protocol notes
Quarterly Clan/mesh; evaluator landscape; adjacent tools
As noticed Renames, forks, dead projects, broken upstream URLs

Pick the matching section; always finish with After every refresh.

Each NixOS release

Each major Nix release

  • [ ] Refresh cheatsheets/cli.md for new, renamed, or removed commands and flags.
  • [ ] Walk 05-cli-and-tooling/ leaves that mention experimental or unstable CLI (nix-command, flakes-related flags, store ops); version-stamp against the releasing Nix version.
  • [ ] Diff experimental feature list vs tracking-stabilization.md / experimental-backlog.md (stabilize / remove / rename).
  • [ ] Note store or protocol behavior changes only where this wiki already covers them; do not invent new APIs.

Quarterly (Clan / mesh, evaluators, adjacent tools)

As noticed (renames / forks / dead projects)

  • [ ] Fix rename or fork callouts (e.g. Snix/Tvix/Lix) on the affected leaf; add a short “former name / status” note if readers will search the old term.
  • [ ] Mark abandoned or misleading projects clearly; prefer primary-source confirmation over Discord lore.
  • [ ] Fix or remove dead upstream URLs; sync sources.md when a canonical row changes.

After every refresh

  • [ ] Run node meta/audit/broken-links.mjs from the repo root; fix any broken relative links introduced or exposed by the pass.
  • [ ] Update sources.md rows if recurring canonical URLs changed or were added.
  • [ ] Leave subject status alone unless the leaf was rewritten enough to need quality-checklist.md again.

See also

References