docs(install): add a Nix section #120

Merged
pti merged 1 commit from docs/install-nix into main 2026-11-02 13:51:20 +01:00
Owner

Adds an "Install with Nix" section to docs/installation.qmd, after "Build with Guix":

  • Profile install from a release tag (nix profile install 'git+https://…?ref=refs/tags/wraptool-v0.10.0').
  • NixOS / Home Manager: the flake input plus packages.${system}.default.
  • Build from a checkout: nix build / nix develop.

It also warns, before the steps, that a flake cannot read Git tags, so a Nix build reports devel+<commit> (0.0.0-dev for wraptool-v0.10.0, which predates #118), and points to the static release binaries for an exact version. The front-matter description now mentions Nix.

Verified:

  • both public flake URLs evaluate anonymously over HTTPS: tag → 0.0.0-dev, main → devel+42803abca7ed
  • local nix build passes
  • not verified: quarto render (the #precompiled-releases link relies on Quarto's auto-generated heading id)

🤖 Generated with Claude Code

Adds an "Install with Nix" section to `docs/installation.qmd`, after "Build with Guix": - **Profile install** from a release tag (`nix profile install 'git+https://…?ref=refs/tags/wraptool-v0.10.0'`). - **NixOS / Home Manager**: the flake input plus `packages.${system}.default`. - **Build from a checkout**: `nix build` / `nix develop`. It also warns, before the steps, that a flake cannot read Git tags, so a Nix build reports `devel+<commit>` (`0.0.0-dev` for `wraptool-v0.10.0`, which predates #118), and points to the static release binaries for an exact version. The front-matter description now mentions Nix. Verified: - both public flake URLs evaluate anonymously over HTTPS: tag → `0.0.0-dev`, `main` → `devel+42803abca7ed` - local `nix build` passes - not verified: `quarto render` (the `#precompiled-releases` link relies on Quarto's auto-generated heading id) 🤖 Generated with [Claude Code](https://claude.com/claude-code)
docs(install): add a Nix section
All checks were successful
Lint / lint (pull_request) Successful in 1m13s
Lint / sonarqube (pull_request) Has been skipped
29bf3817dc
Document installing wraptool from the repository flake: a profile
install from a release tag, a NixOS or Home Manager flake input, and
building from a checkout. Note that a flake build cannot read the
release tag, so it reports devel+<commit> (0.0.0-dev for
wraptool-v0.10.0), and point to the static release binaries for an
exact version.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
pti merged commit f0a41c4141 into main 2026-11-02 13:51:20 +01:00
pti deleted branch docs/install-nix 2026-11-02 13:51:20 +01:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
pti/wraptool!120
No description provided.