docs: correct appliance drift — RAUC reality, backup buttons future-tense, fixture consumers, resolved wizard-error item - #918
Merged
Conversation
… code dual-distribution-plan.md's Phase 2/4 narrative still described the abandoned Rugix Bakery/rugix-ctrl updater and an unbuilt release.sh os-image lane, both contradicted by the document's own bake-off verdict and by scripts/release.sh (no such lane exists). Rewrite both to match what actually shipped: RAUC A/B + systemd-repart + the hand-written GRUB slot-selector, and the manual mkimage.sh/mkbundle.sh flow in appliance-release.md. The Phase 2 backup/restore paragraph asserted dashboard export/restore buttons exist; they don't (os/KNOWN-ISSUES.md's own #786 entry says so) — reworded to planned tense with a cross-reference. os/README.md said the phase-0 quadlet fixtures are consumed by nothing; tests/stack/run.sh diffs pithead's render-quadlet output against them as the parity test's expected output, so reworded to say so. os/KNOWN-ISSUES.md still listed the wizard's failure-surfacing gap as Open; commit 7c6d4ec fixed it (error.txt + last-attempt.json, surfaced by wizard.py/wizard.mjs) — moved to Resolved. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
6 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Audit-confirmed accuracy fixes (code is the source of truth; every claim checked against develop-v2):
docs/dev/dual-distribution-plan.mdphase 2/4 described the abandoned Rugix Bakery updater and a release.sh os-image lane; now names the shipped stack — RAUC A/B + systemd-repart + the hand-written GRUB slot selector, the pithead-boot commit gate, the two-tier reset — and the actual manual image release process with a pointer to appliance-release.md.os/README.mdsaid nothing consumes the quadlet fixtures; the byte-parity test has consumed them since the renderer shipped.os/KNOWN-ISSUES.mdstill listed the wizard failure-surfacing gap as Open; error.txt/last-attempt.json shipped the fix — moved to the resolved section with the mechanism named.make lintgreen (docs-voice, markdownlint). Verifier pass on the branch: clean. Ponytail: docs-only accuracy pass, nothing to cut.🤖 Generated with Claude Code