Skip to content

docs(workstation-v0): add Mac-on-Linux operator runbook sections#133

Open
Copilot wants to merge 2 commits intomainfrom
copilot/add-operator-runbook-mac-on-linux
Open

docs(workstation-v0): add Mac-on-Linux operator runbook sections#133
Copilot wants to merge 2 commits intomainfrom
copilot/add-operator-runbook-mac-on-linux

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented May 2, 2026

Operators had no concise reference for the full install sequence, reboot expectations, Mac polish/keyboard/Lampstand validation, or how to distinguish hard failures from soft gaps.

Changes to docs/workstation/RUNBOOK.md

  • Install sequence — numbered all 15 steps with their install.sh function names so operators know exactly what runs and in what order
  • rpm-ostree reboot notes — explicit 3-step sequence: layer → rpm-ostree status → reboot → re-run; notes steps 2–15 are idempotent
  • Warnings vs hard failures tableok/warn/error/info levels mapped to blocking/non-blocking with copy-pasteable triage commands using --json output
  • Mac polish helper (§5)check-mac-polish.sh expected key=value output, mac-screenshot.sh subcommands, Sushi Quick Look note
  • Keyboard policy helper (§6)check-keyboard-policy.sh expected output, policy_ok=yes acceptance signal, SOURCEOS_REMAP_BACKEND override example
  • Lampstand checks (§7)check-lampstand-unit.sh, doctor JSON filter for lampstand results, all sourceos search and unit lifecycle commands
  • Known gaps & non-goals (§10) — documents soft gaps (Lampstand, fusuma, GNOME extensions, PATH timing) and explicit non-goals (production readiness, non-GNOME/non-Fedora hosts, no script modifications)

No implementation scripts were modified.

…n, and known gaps

Agent-Logs-Url: https://github.com/SociOS-Linux/source-os/sessions/850256af-75b2-4427-990c-f963206a15d4

Co-authored-by: mdheller <21163552+mdheller@users.noreply.github.com>
Copilot AI changed the title [WIP] Add operator runbook for Mac-on-Linux install and validation docs(workstation-v0): add Mac-on-Linux operator runbook sections May 2, 2026
Copilot AI requested a review from mdheller May 2, 2026 19:01
@mdheller mdheller marked this pull request as ready for review May 3, 2026 01:53
Copy link
Copy Markdown
Member

mdheller commented May 5, 2026

Replay review:

This runbook content is useful but the PR is non-mergeable against current main; do not merge stale history.

Preserve the useful content:

  • exact install sequence and function names;
  • rpm-ostree reboot guidance;
  • warning vs hard-failure semantics;
  • Mac polish, keyboard policy, and Lampstand triage commands;
  • explicit known gaps and non-goals.

Recommended action: replay these sections into the current workstation runbook as part of the fresh workstation acceptance cleanup branch. After the replacement PR is open, close this PR as superseded.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

workstation-v0: add operator runbook for Mac-on-Linux install and validation

2 participants