Skip to content

docs(flaky-tests): uploads from forked pull requests, including test collections - #377

Merged
acatxnamedvirtue merged 1 commit into
mainfrom
tylerbeebe/fork-pr-uploads-docs
Sep 30, 2026
Merged

acatxnamedvirtue merged 1 commit into
mainfrom
tylerbeebe/fork-pr-uploads-docs

Conversation

@acatxnamedvirtue

Copy link
Copy Markdown
Contributor

Overview

Adds a Getting Started page, Uploads from Forked Pull Requests (flaky-tests/get-started/fork-pr-uploads). It documents the test-collection fork lane, which shipped last week and until now was described nowhere except the uploader action's input text. It also covers the existing repository lane on the same page.

  • Test collections (new):
    • The admin-only Settings → Uploads → Accept uploads from forked pull requests toggle.
    • allow-forked-pr-uploads: true with test-collection-id on trunk-io/analytics-uploader@v2.
    • CLI --allow-forked-pr-uploads / TRUNK_ALLOW_FORKED_PR_UPLOADS, which requires --test-collection-id.
    • Minimum versions: analytics-cli 0.15.5 (feat(cli): allow uploads from forked pull requests, opted in explicitly analytics-cli#1205) and analytics-uploader v2.1.4 (the @v2 tag is at v2.1.5).
    • How authorization works: the collection ID isn't a secret; turning the setting off takes effect within about a minute; unknown, deleted and disabled collections all get the same refusal; and a refused fork upload warns without failing CI.
  • Repositories without a test collection: the public repo identifier content is moved unchanged from Multiple Repositories and Forks, apart from minor rewording. That page's fork section now links here.
    • This lane is not marked deprecated yet. It stays documented as-is until the v1 API is retired.

Other changes

  • cli-reference.mdx: adds rows for --allow-forked-pr-uploads and --public-repo-id, which the flag table never listed.
  • test-collections.mdx: adds the admin-only fork setting to the Permissions table.
  • docs.json: adds the page after multiple-repositories in Getting Started.

Verify

The preview deployment should show the page in the Getting Started sidebar, and the screenshot should still render in its new location.

🤖 Generated with Claude Code

…t collections

Adds a Getting Started page covering both fork lanes: the new test-collection
opt-in (allow-forked-pr-uploads with test-collection-id; analytics-cli 0.15.5,
analytics-uploader v2.1.4) and the existing repository public repo identifier,
which moves here from Multiple Repositories and Forks. Also adds the two CLI
flags to the reference and the admin-only setting to the collections
permissions table.
@mintlify

mintlify Bot commented Sep 30, 2026 •

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated
trunk 🟢 Ready View Preview Sep 30, 2026, 3:38 PM

@acatxnamedvirtue
acatxnamedvirtue merged commit 7eab71e into main Sep 30, 2026
3 checks passed
@mintlify

mintlify Bot commented Sep 30, 2026

Copy link
Copy Markdown
Contributor

Docs PR opened: #378

Added a September 30 changelog entry announcing that test collections can now accept uploads from forked pull requests.

This branch was successfully deployed

1 active deployment
staging — 0a62399f Deployed Sep 30, 2026 by mintlify[bot]
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.

1 participant