docs: the versioned release exists now, so stop sending users to :next - #45
Merged
Merged
Conversation
v3.8.54 shipped on 2026-09-19 — the first versioned release this fork has ever
cut. Until then the README and the Docker guide were correct to say that only
the rolling :next channel existed. They are not correct any more, and they were
still telling an end user to run a mutable pre-release tag when a stable one is
sitting right there.
README:
- the "Published right now" banner now lists what actually exists: desktop
installers on every GitHub Release, :latest and the immutable :X.Y.Z, the
rolling :next / :next-web, and installation from source;
- the four `docker run` quick-start commands use :latest instead of :next;
- the channel sentence leads with what :latest means and warns, next to the
command rather than only in a later note, that :latest is a moving pointer —
pin :X.Y.Z for anything that has to be reproducible;
- the ":next channel" note drops "today they are the only images this fork
publishes" and now recommends an immutable tag first, digest second.
docs/guides/DOCKER_GUIDE.md carried the same stale claim on the page the README
links to for release channels: "only :next and :next-web. No versioned release
has been published yet, so :latest, :latest-web and the immutable :X.Y.Z tags
are not resolvable."
Replacing a stale claim with an unverified one would have been no better, so
every channel in that table was pulled anonymously before the sentence was
written:
latest HTTP 200 next HTTP 200
latest-web HTTP 200 next-web HTTP 200
3.8.54 HTTP 200 main HTTP 404
main-web HTTP 404
:main and :main-web do NOT exist here — this fork develops on release/v* branches
— so the note says so explicitly instead of implying the whole table is pullable.
The ":latest follows the highest published stable SemVer" claim was verified
against the workflow rather than assumed: docker-publish.yml runs
scripts/ci/should-promote-latest.sh against every v* tag and refuses to promote
:latest for a pre-release identifier or for anything that is not the highest
stable version.
Verification (isolated DATA_DIR/HOME/USERPROFILE/APPDATA):
check-docs-sync exit 0
check-doc-links exit 0
check-fabricated-docs exit 0
check-docs-frontmatter exit 0
check-changelog-integrity exit 0
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
Important Review skippedAuto reviews are disabled on base/target branches other than the default branch. Please check the settings in the CodeRabbit UI or the ⚙️ Run configurationConfiguration used: defaults Review profile: CHILL Plan: Advanced Run ID: You can disable this status message by setting the Use the checkbox below for a quick retry:
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
This was referenced Sep 19, 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.
v3.8.54 shipped on 2026-09-19 — the first versioned release this fork has ever cut. Until then the README and the Docker guide were right to say only the rolling
:nextchannel existed. They are not right any more, and they were still telling an end user to run a mutable pre-release tag while a stable one sits right there.What was false
:latestand the desktop installers begin to exist when a versioned release is cut; until then every command below uses:next":latestresolves:nextis the channel this fork publishes today":latestand:3.8.54publish too:X.Y.Zand:latestappear once a version is released":nextnote:nextand:next-web. No versioned release has been published yet, so:latest,:latest-weband the immutable:X.Y.Ztags are not resolvable"docs/guides/DOCKER_GUIDE.md— the page the README links to for release channelsWhat changed
:latestand immutable:X.Y.Z, rolling:next/:next-web, and source.docker runquick-start commands use:latest.:latestis a moving pointer, pin:X.Y.Zfor anything reproducible.:nextnote recommends an immutable tag first, digest second.Replacing a stale claim with an unverified one would be no better
Every channel in the guide's table was pulled anonymously before the new sentence was written:
:mainand:main-webdo not exist here — this fork develops onrelease/v*branches, notmain— so the note says so outright rather than implying the whole table is pullable.The "
:latestfollows the highest published stable SemVer" claim was checked against the workflow, not assumed:docker-publish.ymlrunsscripts/ci/should-promote-latest.shagainst everyv*tag and refuses to promote:latestfor a pre-release identifier or for anything that is not the highest stable version.Verification
Isolated
DATA_DIR/HOME/USERPROFILE/APPDATA.check-docs-synccheck-doc-linkscheck-fabricated-docscheck-docs-frontmattercheck-changelog-integrityDocumentation only — no runtime code changes.
🤖 Generated with Claude Code