docs: document the Guix container runtime for users #11

Merged
pti merged 1 commit from docs-guix-runtime-userdocs into main 2026-07-07 14:41:37 +02:00
Owner

Brings the user-facing docs in line with the shipped Guix runtime (the design doc/CLAUDE were already updated; this is the docs site).

  • getting-started.qmdup step 2 now says "native Guix container (from manifest.scm) on Guix, else devcontainer"; new "Which container runtime?" subsection covering auto-selection, --runtime, and the isolation model (creds via namespace; git available locally, privileged/remote git via MCP).
  • devcontainers.qmd — callout that on Guix up uses a native container and skips dev containers entirely; up step reworded for runtime selection.
  • isolated-environments.md — the manual "Guix Shell Container" walkthrough now leads with wraptool up as the one-command shortcut it automates.

Docs-only (markdown/Quarto callouts).

🤖 Generated with Claude Code

Brings the user-facing docs in line with the shipped Guix runtime (the design doc/CLAUDE were already updated; this is the docs site). - **getting-started.qmd** — `up` step 2 now says "native Guix container (from manifest.scm) on Guix, else devcontainer"; new **"Which container runtime?"** subsection covering auto-selection, `--runtime`, and the isolation model (creds via namespace; git available locally, privileged/remote git via MCP). - **devcontainers.qmd** — callout that on Guix `up` uses a native container and skips dev containers entirely; `up` step reworded for runtime selection. - **isolated-environments.md** — the manual "Guix Shell Container" walkthrough now leads with `wraptool up` as the one-command shortcut it automates. Docs-only (markdown/Quarto callouts). 🤖 Generated with [Claude Code](https://claude.com/claude-code)
docs: document the Guix container runtime for users
All checks were successful
Lint / lint (pull_request) Successful in 10s
82014f9dd2
Update the user-facing docs to the shipped model: `wraptool up` auto-selects a
native Guix container (built from the project's manifest.scm) on a Guix host,
else devcontainer. getting-started gains a "Which container runtime?" section
(auto-selection, --runtime, and the credential-isolation / local-vs-privileged
git note); devcontainers.qmd gets a callout that Guix hosts skip dev containers
entirely and fixes the `up` step to mention runtime selection; the manual
"Guix Shell Container" walkthrough in isolated-environments.md now points at
`wraptool up` as the one-command shortcut.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
pti merged commit 808dd8fb2d into main 2026-07-07 14:41:37 +02:00
pti deleted branch docs-guix-runtime-userdocs 2026-07-07 14:41:37 +02: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!11
No description provided.