Repository navigation
docs: add 0.17.x to 1.0.0 upgrade notes (TRUNK-23152) - #1329
Merged
Merged
Conversation
acatxnamedvirtue
force-pushed
the
tylerbeebe/trunk-23149-23372-v2-key-or-jwt
branch
from
November 13, 2026 20:21
761afcb to
103ae54
Compare
acatxnamedvirtue
force-pushed
the
tylerbeebe/trunk-23152-upgrade-notes
branch
from
November 13, 2026 20:21
df945fe to
d768461
Compare
acatxnamedvirtue
force-pushed
the
tylerbeebe/trunk-23149-23372-v2-key-or-jwt
branch
from
November 16, 2026 18:16
103ae54 to
6ea6c13
Compare
acatxnamedvirtue
force-pushed
the
tylerbeebe/trunk-23152-upgrade-notes
branch
from
November 16, 2026 18:16
d768461 to
f33fa69
Compare
acatxnamedvirtue
force-pushed
the
tylerbeebe/trunk-23149-23372-v2-key-or-jwt
branch
from
November 16, 2026 22:26
6ea6c13 to
129c31b
Compare
acatxnamedvirtue
force-pushed
the
tylerbeebe/trunk-23152-upgrade-notes
branch
from
November 16, 2026 22:27
1dc6f28 to
81f4092
Compare
acatxnamedvirtue
force-pushed
the
tylerbeebe/trunk-23149-23372-v2-key-or-jwt
branch
from
November 16, 2026 22:55
129c31b to
49c473e
Compare
acatxnamedvirtue
force-pushed
the
tylerbeebe/trunk-23152-upgrade-notes
branch
2 times, most recently
from
November 16, 2026 23:07
4a9d96b to
ca96e11
Compare
acatxnamedvirtue
force-pushed
the
tylerbeebe/trunk-23149-23372-v2-key-or-jwt
branch
from
November 17, 2026 13:18
89f03aa to
639c348
Compare
acatxnamedvirtue
force-pushed
the
tylerbeebe/trunk-23152-upgrade-notes
branch
3 times, most recently
from
November 17, 2026 13:29
20241aa to
cdffc42
Compare
acatxnamedvirtue
force-pushed
the
tylerbeebe/trunk-23152-upgrade-notes
branch
from
November 17, 2026 15:41
cdffc42 to
2506733
Compare
acatxnamedvirtue
changed the base branch from
tylerbeebe/trunk-23149-23372-v2-key-or-jwt
to
main
November 17, 2026 15:41
|
😎 Merged successfully - details. |
UPGRADING.md lists what a 0.17.x user has to change for 1.0.0: a v2 API key or JWT, a required test collection, the removed flags and variables, the fork lane with no v1 fallback, the summary on stdout, GUID links, the telemetry host, and which analytics-uploader versions pick up 1.0.0. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…-23152) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…152) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…otes (TRUNK-23152) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ly when promoted to latest (TRUNK-23152) - The rspec gem 1.0.0 raises RSpec::Trunk::ConfigurationError without a collection id or with an organization token (#1337), with DISABLE_RSPEC_TRUNK_FLAKY_TESTS=true to opt out and a ~> 0.17.0 pin to stay. - analytics-uploader v2.1.7 and older follow channel.json or GitHub's latest, which move only when 1.0.0 is promoted to latest (#1339). - trunk CLI 0.0.14 runs analytics-cli 1.x unless pinned (trunk-io/trunk2#8640). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
trunk-io/trunk2#8640 moves the trunk CLI's flakytests to channel-1.json, so promote-latest no longer holds it back, and channel-1.json becomes a pointer that must not be removed. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
acatxnamedvirtue
force-pushed
the
tylerbeebe/trunk-23152-upgrade-notes
branch
from
November 17, 2026 18:38
4e6b409 to
0b30f05
Compare
acatxnamedvirtue
requested review from
TylerJang27,
dfrankland and
max-trunk
November 17, 2026 18:38
Users only ever pass a v2 API key: the Trunk JWT is how the trunk CLI hands a credential to analytics-cli, so the user-facing docs drop it. Also drop the channel pointer names, the fork lane's token swap, the telemetry route and format, and the test link paths, keeping what a user has to do. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
max-trunk
approved these changes
Nov 17, 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.
Part of TRUNK-23152
Based on
main: #1328, #1313, #1314, #1339 and #1337 have merged.Adds
UPGRADING.md, the 0.17.x → 1.0.0 upgrade notes, and links it from the README's Credentials section. It covers:--test-collection-id;--output-format json;telemetry.trunk.iotoapi.trunk.io;@v2stay on 0.x;trunk flakytestsrunning 1.x from trunk CLI 0.0.14 (trunk-io/trunk2#8640);The user-facing docs (
UPGRADING.md, the README's Credentials section and the rspec gem's README) leave out implementation details. Users only pass a v2 API key: the Trunk JWT is how the trunk CLI hands a credential to analytics-cli, so the docs only say thattrunk flakytestshandles it. They also don't name the channel pointer files, the fork lane's token swap, the telemetry route or the test link paths.Also fixes
CONTRIBUTING.md, which said thetrunkCLI readschannel.json. From 0.0.14 (trunk-io/trunk2#8640) it readschannel-1.json. Sopromote-latestdoesn't hold it back, andchannel-1.jsonmust never be removed or pointed at another major.The draft 1.0.0 release body, which links to these notes, will be pasted into the release once it's cut.
Testing
trunk checkandtrunk fmtare clean. Docs only.🤖 Generated with Claude Code