Skip to content

Say when an integration syncs Core, and why not sooner - #22

Merged
liuyingjierun merged 1 commit into
mainfrom
docs/core-sync-timing
Sep 6, 2026
Merged

liuyingjierun merged 1 commit into
mainfrom
docs/core-sync-timing

Conversation

@liuyingjierun

Copy link
Copy Markdown
Contributor

The rule two scripts already implement, written down where the boundary is described.

tools/sync-core.sh and tools/check-core-freshness.mjs between them decide when an integration's vendored snapshot is allowed to be behind, but docs/projects.md said only that Core assets "flow into plugin repositories" — nothing about timing. Reading the repositories, the natural inference is the wrong one: that a snapshot two Core versions behind is an outstanding chore. It is not. A .vsix, a plugin zip and the source archive GitHub attaches to a tag all freeze whatever snapshot they were built from, so re-syncing the moment Core publishes aligns the source and nothing a user can install.

So the doc now states the rule and the reason, and names the two modes the freshness check actually has: advisory between releases, strict at the packaging gate. It also names the exception — a security-grade Core release is the one case that should not wait for the next feature release.

Documentation only; no runtime or tooling change.

The rule was implied by two scripts and written down nowhere: an integration
syncs as part of its own release, because a repository that re-syncs when Core
publishes has aligned its source and nothing a user can install.
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
jsray 9b7be5f Commit Preview URL

Branch Preview URL
Sep 06 2026, 11:24 AM

@liuyingjierun
liuyingjierun merged commit dc952ee into main Sep 6, 2026
6 checks passed
@liuyingjierun
liuyingjierun deleted the docs/core-sync-timing branch September 6, 2026 11:25
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