Skip to content

Document quarantining without uploading via --dry-run - #310

Merged
dfrankland merged 2 commits into
mainfrom
dry-run-quarantine-docs
Aug 10, 2026
Merged

Document quarantining without uploading via --dry-run#310
dfrankland merged 2 commits into
mainfrom
dry-run-quarantine-docs

Conversation

@dfrankland

Copy link
Copy Markdown
Member

Summary

The Analytics CLI's --dry-run flag (env: TRUNK_DRY_RUN) was completely undocumented publicly — the only mention anywhere was an internal dev README in the analytics-cli repo. It's the supported way to have quarantining gate a CI job without uploading test results to Trunk: the quarantine check still runs and still overrides the exit code, but the bundle is written to a local ./bundle_upload directory instead of being uploaded.

Changes

  • flaky-tests/quarantining/index.mdx: new "Quarantining without uploading" section with an example command and caveats (token/network still required for the quarantine query; the run won't appear in the dashboard or feed detection).
  • flaky-tests/reference/cli-reference.mdx: added a --dry-run row to the upload/test options table, linking to the new section.

The behavior is covered by a new CLI test: trunk-io/analytics-cli#1155.

🤖 Generated with Claude Code

Adds a "Quarantining without uploading" section to the quarantining
page and a --dry-run row to the CLI reference options table. The flag
was previously undocumented: it skips the upload (writing the bundle to
./bundle_upload locally) while the quarantine check still runs and
still overrides the exit code.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
trunk 🟢 Ready View Preview Aug 10, 2026, 7:14 PM

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@dfrankland
dfrankland merged commit 2535e23 into main Aug 10, 2026
2 checks passed
@dfrankland
dfrankland deleted the dry-run-quarantine-docs branch August 10, 2026 20:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants