Skip to content

docs: follow-ups deferred from #276 - #289

Merged
jeefy merged 7 commits into
projectbluefin:mainfrom
jeefy:docs/deferred-followups
Sep 29, 2026
Merged

jeefy merged 7 commits into
projectbluefin:mainfrom
jeefy:docs/deferred-followups

Conversation

@jeefy

@jeefy jeefy commented Sep 29, 2026

Copy link
Copy Markdown
Collaborator

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.

  • ci-tooling.md: the documented taiki-e/install-action SHA had gone stale against the workflows; the examples now show the pin format with a placeholder and point at build.yml for the current value.
  • factory-integration.md: dropped the claim that podman ships as an optional sysext. The only container runtime we ship is containerd, inside the opt-in kubeadm sysext.
  • Dedupe (hard rule 6): the sysupdate-signing.asc / import-pubring.pgp pair, gen-dev-keys behaviour, and CI secrets keep one canonical home (systemd-sysupdate-verification.md for the release-signing key, secure-boot-keys.md for PK/KEK/DB/module keys); the build skill keeps only the rotation-needs-a-new-image-version rationale and points at the rest. The "a release publishes dist/diskless/ as-is" fact stays canonical in the ci-tooling.md release job (AGENTS.md keeps its one-line summary); the other restatements point there.
  • gap-analysis-distros.md §6: trimmed the source list that restated section 2's inline links down to one docs-root link per distro.
  • New skill usb-installer.md: extracted the offline USB installer content from ddi-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>.raw layout and boot flow, unattended installs via the systemd.unit-dropin.systemd-sysinstall.service credential, the firstboot root-password prompt drop-in, and credentials on the ESP). ddi-installer.md keeps a one-line pointer.
  • Routing: docs/skills/index.md and the AGENTS.md routing table now list booty-integration.md, secure-boot-keys.md, and usb-installer.md.
  • README.md: new "Download a release" section ahead of the build quick start: GitHub Releases (v<YY.MM.run>) and ghcr.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

jeefy and others added 7 commits September 29, 2026 13:59
…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
jeefy merged commit cc139eb into projectbluefin:main Sep 29, 2026
6 checks passed
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>
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.

1 participant