docs: drop the duplicated UPDATING.md sections left by the 0.3.0 rewrite - #13
Merged
Conversation
The 0.3.0 doc rewrite (2740ee8) inserted its new content above the old text instead of replacing it, orphaning three chunks of the previous revision: the tail of the intro, the tail of "Determining the upstream version", and the whole 3-step "Applying the bump". A later rename pass then swapped the image and repo names inside those orphans, so the dead copy read as current rather than obviously stale — which is why it survived this long. Drop all three. The surviving "Applying the bump" is a strict superset of the dead one: it adds the image-must-be-rebuilt-first step and the file-exchange defaults re-check. The only thing the dead copy stated on its own — where the pin lives in manifest/index.ts — is already given immediately above the section. Also correct the -N revision guidance, which told the packager unconditionally to "keep the explicit -N revision". An unsuffixed tag is revision 0, so a first build of a SimpleX version has no suffixed form to pin, and the bare 6.5.6 pin in the manifest was following that rather than deviating from it. Both the explainer and step 2 now say to pin the explicit revision where one exists. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
MattDHill
approved these changes
Aug 7, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
UPDATING.mdhas been carrying three orphaned chunks of an older revision of itself, including a second, divergent copy of the entire Applying the bump section. A packager following the file could read either one.What happened
The 0.3.0 doc rewrite (2740ee8) inserted its new content above the old text instead of replacing it. Three pieces of the previous revision were left behind:
A later rename pass then swapped
lundog/simplex-chat→lundog/simplex-websocket-bridgeinside those orphans, so the dead copy reads as current rather than obviously stale. That is most likely why it survived this long.What this changes
Drops all three orphans. The surviving "Applying the bump" is a strict superset of the dead one — it adds the image-must-be-rebuilt-first step and the file-exchange defaults re-check, neither of which the old copy had. The one fact the dead copy stated on its own, where the pin lives in
manifest/index.ts, is already given immediately above the section.Corrects the
-Nrevision guidance. Step 2 told the packager unconditionally to "keep the explicit-Nrevision", which the repo cannot follow: per the file's own explainer an unsuffixed tag is revision 0, so a first build of a SimpleX version has no suffixed form to pin. The manifest's bare6.5.6pin was following that, not deviating from it. Both the explainer and step 2 now say to pin the explicit revision where one exists, which keeps the original intent — don't let the tag shift underneath you.Verification
Docs only; no source, manifest, or version change, so the build is untouched.
##heading now appears exactly once, and the file reads top to bottom with no mid-sentence breaks.lundog/simplex-chatrepo is indeed frozen at6.5.5-1with no newer builds, and6.5.5/6.5.5-2are genuinely the same image (bothsha256:f46cca57449e…).prettierscript is scoped tostartos/).Note on #12
This is independent of #12 and does not conflict with it — that PR does not touch
UPDATING.md.One follow-up is deliberately not included here: step 4 says to bump the package
versionwithout stating how to choose it, which is correct under the current wrapper-versioning scheme. If #12's renumbering half lands, this step should gain the rule that the package version tracks the bundled SimpleX version. Left out on purpose, since that half was explicitly offered as revertible.🤖 Generated with Claude Code