Documentation Gap
The docs site ships two sidebar sections for one project: bootc-migrate and the stale pre-rename duplicate bootc-migrate-composefs (the GitHub repo tuna-os/bootc-migrate-composefs was renamed to tuna-os/bootc-migrate on 2026-07-24; the old URL redirects).
docs/bootc-migrate-composefs/ (5 pages, synced 2026-07-04 → 07-19, pre-rename) is a duplicate of docs/bootc-migrate/ (synced 2026-08-08, post-rename) — same project, same "Migrate Bluefin → Dakota" quickstart, same architecture.- The two sections give contradictory instructions:
bootc-migrate-composefs pages tell users to download/run bootc-migrate-composefs; bootc-migrate pages tell users to download/run bootc-migrate. Both appear in the sidebar side-by-side (sidebars.ts: "bootc-migrate" and "bootc-migrate-composefs" categories under Tools).
- The composefs pages' CI badges, release URLs, and ghcr image references point at the old
bootc-migrate-composefs repo name.
- Links to
tuna-os/bootc-migrate-composefs/issues/N inside the composefs pages resolve to tuna-os/bootc-migrate issues after the redirect, so they don't break — but the duplicated content is stale (e.g. filesystem-support.md differs: the composefs copy lacks the Btrfs subvol=/var and /home↔/var/home sections present in the current one).
Recommendation
- Remove the stale
docs/bootc-migrate-composefs/ section (directory + sidebar category) — docs/bootc-migrate/ is the canonical, more complete documentation.
- If URL continuity matters, add a client-side redirect from
/docs/bootc-migrate-composefs/* to /docs/bootc-migrate/* (the site does not currently configure the redirects plugin).
Note: docs/bootc-migrate/index.md also currently documents 404 release URLs (fixed in tuna-os/bootc-migrate PR #119; the next sync-org-docs.mjs run will propagate the fix).
Filed by guide agent (ACMM L6 — full mode)
Documentation Gap
The docs site ships two sidebar sections for one project:
bootc-migrateand the stale pre-rename duplicatebootc-migrate-composefs(the GitHub repotuna-os/bootc-migrate-composefswas renamed totuna-os/bootc-migrateon 2026-07-24; the old URL redirects).docs/bootc-migrate-composefs/(5 pages, synced 2026-07-04 → 07-19, pre-rename) is a duplicate ofdocs/bootc-migrate/(synced 2026-08-08, post-rename) — same project, same "Migrate Bluefin → Dakota" quickstart, same architecture.bootc-migrate-composefspages tell users to download/runbootc-migrate-composefs;bootc-migratepages tell users to download/runbootc-migrate. Both appear in the sidebar side-by-side (sidebars.ts: "bootc-migrate" and "bootc-migrate-composefs" categories under Tools).bootc-migrate-composefsrepo name.tuna-os/bootc-migrate-composefs/issues/Ninside the composefs pages resolve totuna-os/bootc-migrateissues after the redirect, so they don't break — but the duplicated content is stale (e.g.filesystem-support.mddiffers: the composefs copy lacks the Btrfssubvol=/varand/home↔/var/homesections present in the current one).Recommendation
docs/bootc-migrate-composefs/section (directory + sidebar category) —docs/bootc-migrate/is the canonical, more complete documentation./docs/bootc-migrate-composefs/*to/docs/bootc-migrate/*(the site does not currently configure the redirects plugin).Note:
docs/bootc-migrate/index.mdalso currently documents 404 release URLs (fixed in tuna-os/bootc-migrate PR #119; the nextsync-org-docs.mjsrun will propagate the fix).Filed by guide agent (ACMM L6 — full mode)