Skip to content

docs(deps): fold the two NexusKit comments into one - #37

Merged
nxships merged 1 commit into
mainfrom
docs/packages-comment
Aug 11, 2026
Merged

docs(deps): fold the two NexusKit comments into one#37
nxships merged 1 commit into
mainfrom
docs/packages-comment

Conversation

@nxships

@nxships nxships commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

Comment-only. No version changes.

The block had grown two comments that no longer agreed. The second explained why NexusKit.Sync sat a patch ahead of the others — true for about twenty minutes, and false since #36 moved all five to 0.5.1. A comment describing a state that no longer exists is worse than none: the next reader trusts it.

What is left is the part that outlives any particular version:

  • They move together, because NexusKit publishes them together. A floor that lags names a version the feed may never have carried, which restores the substitute and fails the build on NU1603 — the failure this repository already hit once.
  • Ranges stay open-ended. An exact pin stops a consumer picking up a patch, and for NexusKit.Sync it is worse than inconvenient: pinning the protocol is how a client ends up unable to follow a server that has moved on.

NexusKit.Sync also joins the list alphabetically instead of trailing it. There is nothing special about that line any more.

They had drifted apart: the second still explained why Sync sat a patch ahead
of the others, which stopped being true when all five moved to 0.5.1. What is
left is the rule that outlives any particular version — they move together
because NexusKit publishes them together, and the ranges stay open-ended.

Sync joins the list in alphabetical order rather than trailing it; there is no
longer anything special about that line.
@nxships
nxships enabled auto-merge (squash) August 11, 2026 11:45
@nxships
nxships merged commit a8becd9 into main Aug 11, 2026
2 checks passed
@nxships
nxships deleted the docs/packages-comment branch August 11, 2026 11:46
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