docs: record the branch/release model + sanitize progress
Document the main=dev / v1=release-pointer model in flake.nix (where the v1 ref is defined) and mark the repo-sanitize roadmap items shipped (installer prune, option-table reconcile, settings untrack, branch realignment). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
@@ -148,14 +148,21 @@ how to override it. Items marked ✓ are shipped.
|
|||||||
cache. Remaining (optional): a session-level `SSH_AUTH_SOCK` export so GUI
|
cache. Remaining (optional): a session-level `SSH_AUTH_SOCK` export so GUI
|
||||||
clients launched outside a shell also see the agent.
|
clients launched outside a shell also see the agent.
|
||||||
- **Sanitize & organize the repo:** a housekeeping pass for consistency
|
- **Sanitize & organize the repo:** a housekeeping pass for consistency
|
||||||
and clarity. Candidate targets (scope still to be defined): prune
|
and clarity.
|
||||||
now-redundant config (e.g. the installer still writes
|
- ✓ pruned now-redundant config: the installer no longer writes
|
||||||
`console.useXkbConfig` / `boot.initrd.systemd.enable` into `system.nix`,
|
`console.useXkbConfig` / `boot.initrd.systemd.enable` into `system.nix`
|
||||||
which are distro-wide defaults as of the LUKS-keymap fix); reconcile the
|
(distro-wide defaults since the LUKS-keymap fix), nor the offline-pin
|
||||||
README option tables with the actual `nomarchy.*` surface; audit
|
test fixture in `flake.nix`.
|
||||||
comments/docs for drift against the code; and re-check that every file
|
- ✓ reconciled the README option tables with the live `nomarchy.*`
|
||||||
still earns its place under the `modules`/`hosts`/`themes`/`pkgs`/`tools`
|
surface (added keys/fastfetch/snapper/greeter.autoLogin).
|
||||||
rule of thumb.
|
- ✓ untracked `.claude/settings.local.json` (machine-local) + gitignored.
|
||||||
|
- ✓ **branch/release model:** `main` is the development default; `v1` is
|
||||||
|
the release pointer downstreams pin (`?ref=v1`), advanced to main once
|
||||||
|
a batch is tested — rolling, no tags. Brought `main` current (it was a
|
||||||
|
stale legacy-merge), and deleted the dead `refactor` / `wave/nixos-26.05`
|
||||||
|
branches (kept `legacy` for history). See the comment in `flake.nix`.
|
||||||
|
- Remaining (optional): re-check that every file still earns its place
|
||||||
|
under the `modules`/`hosts`/`themes`/`pkgs`/`tools` rule of thumb.
|
||||||
- **Full docs review & restructure:** a dedicated pass over all the prose,
|
- **Full docs review & restructure:** a dedicated pass over all the prose,
|
||||||
not just the code-adjacent cleanup the repo-sanitize item covers. The
|
not just the code-adjacent cleanup the repo-sanitize item covers. The
|
||||||
README has grown to ~540 lines with a ~200-line roadmap inline — the
|
README has grown to ~540 lines with a ~200-line roadmap inline — the
|
||||||
|
|||||||
@@ -51,8 +51,11 @@
|
|||||||
(nixpkgs.lib.concatStringsSep "\n"
|
(nixpkgs.lib.concatStringsSep "\n"
|
||||||
(builtins.attrNames nixos-hardware.nixosModules));
|
(builtins.attrNames nixos-hardware.nixosModules));
|
||||||
nixpkgsPath = nixpkgs.outPath;
|
nixpkgsPath = nixpkgs.outPath;
|
||||||
# v1 is the release branch: installed machines track it on
|
# Branch model: `main` is the development default; `v1` is the
|
||||||
# `nix flake update` instead of the forge's default branch.
|
# release pointer — the stable line for the NixOS 26.05 rewrite,
|
||||||
|
# advanced to main once a batch is tested (rolling, no tags). A
|
||||||
|
# future major bump would become `v2`. Installed machines track
|
||||||
|
# `?ref=v1` on `nix flake update`, not the forge's default branch.
|
||||||
flakeUrl = "git+${gitUrl}?ref=v1";
|
flakeUrl = "git+${gitUrl}?ref=v1";
|
||||||
# Future updates re-resolve from the forge (original); the install
|
# Future updates re-resolve from the forge (original); the install
|
||||||
# itself resolves from the ISO store (locked = path) — fully
|
# itself resolves from the ISO store (locked = path) — fully
|
||||||
|
|||||||
Reference in New Issue
Block a user