Cutting a release does not update the public site's release notes #1504

Closed
opened 2026-10-27 13:40:40 +00:00 by sam · 0 comments
Owner

The Astro site (sam/catlow-tech) vendors archie-core's docs/news/releases.json into src/content/releases/releases.json, and nothing in the release process re-runs that sync. Discovered 2026-09-22: archie-core had 96 releases ending archied/1.35.0 while the app still had 92 ending archied/1.32.1, so /news/archied/{1.33.0,1.34.0,1.35.0} and /news/archie/1.35.0 were 404 on the live site for the whole evening. It was invisible because MkDocs was serving those same notes from the same canonical JSON; when MkDocs was removed from offloaded.dev the three pages briefly existed nowhere. Fix direction: make the sync a step of the release flow (or have the app build pull the canonical artifact) rather than a manual command someone has to remember. Note the app is a separate repo with its own CI, so the mechanism has to cross the repo boundary.

Close reason

done


Imported from beads archie-core-p606 · GitHub #1040 · type task · priority P1 · created 2026-09-22 · closed 2026-09-28

The Astro site (sam/catlow-tech) vendors archie-core's docs/news/releases.json into src/content/releases/releases.json, and nothing in the release process re-runs that sync. Discovered 2026-09-22: archie-core had 96 releases ending archied/1.35.0 while the app still had 92 ending archied/1.32.1, so /news/archied/{1.33.0,1.34.0,1.35.0} and /news/archie/1.35.0 were 404 on the live site for the whole evening. It was invisible because MkDocs was serving those same notes from the same canonical JSON; when MkDocs was removed from offloaded.dev the three pages briefly existed nowhere. Fix direction: make the sync a step of the release flow (or have the app build pull the canonical artifact) rather than a manual command someone has to remember. Note the app is a separate repo with its own CI, so the mechanism has to cross the repo boundary. ### Close reason done --- _Imported from beads `archie-core-p606` · GitHub #1040 · type task · priority P1 · created 2026-09-22 · closed 2026-09-28_
sam added the hightask labels 2026-10-27 13:40:40 +00:00
sam self-assigned this 2026-10-27 13:40:40 +00:00
sam closed this issue 2026-10-27 13:40:40 +00:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: sam/archie#1504