Skip to content

Say when to bump the pinned anchor-v2-testing revision - #134

Open
mikemaccana wants to merge 1 commit into
mainfrom
claude/harness-pin-note
Open

Say when to bump the pinned anchor-v2-testing revision#134
mikemaccana wants to merge 1 commit into
mainfrom
claude/harness-pin-note

Conversation

@mikemaccana

Copy link
Copy Markdown
Collaborator

The comment beside the pinned anchor-v2-testing revision explained why it is pinned but named nothing that should ever cause it to change. The --no-idl workaround a few lines away points at anchor#4947 as its removal trigger; this one pointed at nothing, so a reader six months from now had no way to tell whether the revision was still the right one, or what would make it wrong.

The added lines say:

# Bump the rev deliberately, never automatically: `anchor-next` is where v2
# development happens, so a later revision can carry breakage as easily as
# fixes. When `anchor-v2-testing` reaches crates.io, drop the git source for
# an ordinary version.

Applied to all 56 manifests carrying the dependency. Comments only: no dependency, version or code changes, so nothing to verify beyond CI.

Two details behind the wording, in case they are worth arguing with:

"deliberately, never automatically" rather than "keep it current". anchor-next is the active v2 development branch, not a release branch. A newer revision is not automatically a better one, and this repository has no signal that would catch a regression in it beyond CI going red.

"drop the git source" is the real end state. The pin exists only because crates.io has no anchor-v2-testing. Once it is published, none of this applies and an ordinary version requirement replaces the whole block.


Generated by Claude Code

The comment explained why `anchor-v2-testing` is pinned but named nothing
that should cause it to change, unlike the `--no-idl` workaround beside it
which points at anchor#4947 as its removal trigger. Someone reading this in
six months had no way to tell whether the rev was still the right one.

Now it says: bump deliberately rather than automatically, because
`anchor-next` is the v2 development branch and a later revision can carry
breakage as easily as fixes; and when `anchor-v2-testing` reaches crates.io,
the git source goes away entirely.
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.

2 participants