docs: webroot-swap is a deploy-host tool, not live-USB — correct runbook note slipped through in #280 #282

Merged
clawdie merged 1 commit from docs/runbook-webroot-swap-fix into main 2026-07-19 20:23:28 +02:00
Owner

The RELEASE-BUILD-RUNBOOK blockquote added in #280 claimed "The live USB now
stages the webroot-swap deploy contract (/usr/local/libexec/colibri/webroot-swap)"
and linked docs/architecture/webroot-swap.md. Both are wrong:

  • The ISO build stages no webroot-swap (grep across build.sh/scripts/packages
    = zero hits). webroot-swap is a colibri DEPLOY-HOST tool (packaging/freebsd/
    webroot-swap.sh, installed on the production host), not a live-USB component.
  • docs/architecture/webroot-swap.md is a dangling reference — the iso repo has
    no docs/architecture/ dir.

Rewritten to state plainly that webroot-swap is a production-host tool the live
USB does not ship, and to point at the real source file. Caught in review of #280
but the fixup didn't ship before that PR merged.

./scripts/check-format.sh green.

The RELEASE-BUILD-RUNBOOK blockquote added in #280 claimed "The live USB now stages the webroot-swap deploy contract (/usr/local/libexec/colibri/webroot-swap)" and linked docs/architecture/webroot-swap.md. Both are wrong: - The ISO build stages no webroot-swap (grep across build.sh/scripts/packages = zero hits). webroot-swap is a colibri DEPLOY-HOST tool (packaging/freebsd/ webroot-swap.sh, installed on the production host), not a live-USB component. - docs/architecture/webroot-swap.md is a dangling reference — the iso repo has no docs/architecture/ dir. Rewritten to state plainly that webroot-swap is a production-host tool the live USB does not ship, and to point at the real source file. Caught in review of #280 but the fixup didn't ship before that PR merged. ./scripts/check-format.sh green.
docs: webroot-swap is a deploy-host tool, not live-USB — correct runbook note slipped through in #280
All checks were successful
format-check / prettier (pull_request) Successful in 22s
f77972f65e
The RELEASE-BUILD-RUNBOOK blockquote added in #280 claimed "The live USB now
stages the webroot-swap deploy contract (/usr/local/libexec/colibri/webroot-swap)"
and linked docs/architecture/webroot-swap.md. Both are wrong:

- The ISO build stages no webroot-swap (grep across build.sh/scripts/packages
  = zero hits). webroot-swap is a colibri DEPLOY-HOST tool (packaging/freebsd/
  webroot-swap.sh, installed on the production host), not a live-USB component.
- docs/architecture/webroot-swap.md is a dangling reference — the iso repo has
  no docs/architecture/ dir.

Rewritten to state plainly that webroot-swap is a production-host tool the live
USB does not ship, and to point at the real source file. Caught in review of #280
but the fixup didn't ship before that PR merged.

./scripts/check-format.sh green.
clawdie deleted branch docs/runbook-webroot-swap-fix 2026-07-19 20:23: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
clawdie/clawdie-iso!282
No description provided.