Repository navigation
docs: follow-ups deferred from #276 - #289
Merged
Merged
Conversation
…amples The documented taiki-e/install-action SHA went stale the next time the workflows repinned. Show the pin format with a placeholder and point at build.yml for the current value, which the prose already told readers to check. Deferred from projectbluefin#276. Assisted-by: Claude Opus 5.5 via GitHub Copilot Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
No podman sysext exists or is planned; the only container runtime we ship is containerd, inside the opt-in kubeadm sysext. Say that instead of implying podman (and other runtimes) ship as optional sysexts. Deferred from projectbluefin#276. Assisted-by: Claude Opus 5.5 via GitHub Copilot Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Hard rule 6. The sysupdate-signing.asc / import-pubring.pgp pair, the gen-dev-keys behaviour, and the CI secrets were restated in ddi-installer-build.md, and the release-publishes-as-is fact was restated in both build and architecture skills. Keep the key inventory and gen-dev-keys in secure-boot-keys.md, the release-signing key in systemd-sysupdate-verification.md, and the publish contract in the ci-tooling.md release job; the build skill keeps only the rotation-needs-a-new-image-version rationale and points at the rest. Deferred from projectbluefin#276. Assisted-by: Claude Opus 5.5 via GitHub Copilot Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Section 2 already links every specific claim inline; section 6 restated the same URLs. Keep one link per distro documentation root. Deferred from projectbluefin#276. Assisted-by: Claude Opus 5.5 via GitHub Copilot Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
The installer section from projectbluefin#264/projectbluefin#268/projectbluefin#277 lived inside ddi-installer.md. Move it to docs/skills/usb-installer.md covering the image layout and boot flow, unattended installs through the systemd.unit-dropin.systemd-sysinstall.service credential, the firstboot root-password prompt drop-in, and provisioning the installed disk from its ESP; ddi-installer.md keeps a one-line pointer and a short artifact table row. ddi-installer.md's key and release paragraphs also collapse to pointers (the dedupe from the previous commit). Deferred from projectbluefin#276. Assisted-by: Claude Opus 5.5 via GitHub Copilot Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
All three skill files existed (or were just added) without a row in the lazy-load routing table. List them in docs/skills/index.md and in the AGENTS.md skill routing table. Deferred from projectbluefin#276. Assisted-by: Claude Opus 5.5 via GitHub Copilot Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Point evaluators at the published artifacts before the build-oriented quick start: the GitHub Release and OCI artifact, which file covers a diskless USB boot versus an offline install versus Booty network boot, and where the verification steps live. Deferred from projectbluefin#276. Assisted-by: Claude Opus 5.5 via GitHub Copilot Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
jeefy
added a commit
that referenced
this pull request
Sep 29, 2026
…er logs (#292) A push to main cancelled the in-progress run for the previous merge (#289 cancelled 6d49f9b's run), so that version never released. Only pull requests now cancel superseded runs; main runs queue in the same group. The boot-test log upload also missed dist/dogfood-installer/, so the offline installer test's serial logs were lost on failure. Assisted-by: Claude Opus 5.5 via GitHub Copilot Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
jeefy
added a commit
that referenced
this pull request
Sep 30, 2026
Resolve docs/skills/ddi-installer.md against #289's dedupe: keep main's pointer to ci-tooling.md for the release layout and add this branch's rehearsal-only note for `just publish-oci`. Assisted-by: Claude Opus 5.5 via GitHub Copilot Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
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
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.
Follow-ups deferred from #276. All blocking PRs have merged. Docs-only;
python3 .github/scripts/docs-checks.py,pytest tests/unit, and bats all pass.taiki-e/install-actionSHA had gone stale against the workflows; the examples now show the pin format with a placeholder and point atbuild.ymlfor the current value.podmanships as an optional sysext. The only container runtime we ship is containerd, inside the opt-in kubeadm sysext.sysupdate-signing.asc/import-pubring.pgppair,gen-dev-keysbehaviour, and CI secrets keep one canonical home (systemd-sysupdate-verification.mdfor the release-signing key,secure-boot-keys.mdfor PK/KEK/DB/module keys); the build skill keeps only the rotation-needs-a-new-image-versionrationale and points at the rest. The "a release publishesdist/diskless/as-is" fact stays canonical in theci-tooling.mdrelease job (AGENTS.md keeps its one-line summary); the other restatements point there.usb-installer.md: extracted the offline USB installer content fromddi-installer.md(the feat(installer): offline USB installer image booting into systemd-sysinstall #264/fix(installer): boot offline, allow credential overrides, quiet repart warnings #268/ci: boot-test the offline USB installer end to end #277 material:bluefin-server-installer_<ver>.rawlayout and boot flow, unattended installs via thesystemd.unit-dropin.systemd-sysinstall.servicecredential, the firstboot root-password prompt drop-in, and credentials on the ESP).ddi-installer.mdkeeps a one-line pointer.docs/skills/index.mdand the AGENTS.md routing table now listbooty-integration.md,secure-boot-keys.md, andusb-installer.md.v<YY.MM.run>) andghcr.io/projectbluefin/bluefin-server, which file covers diskless USB boot vs offline install vs Booty network boot, and a pointer to the canonical verification skill instead of restated steps.Ref: #276