Skip to content

docs(size-analysis): Document status check rules API#17558

Open
cameroncooke wants to merge 3 commits intomasterfrom
cameroncooke/docs/eme-1061-size-status-rules-api
Open

docs(size-analysis): Document status check rules API#17558
cameroncooke wants to merge 3 commits intomasterfrom
cameroncooke/docs/eme-1061-size-status-rules-api

Conversation

@cameroncooke
Copy link
Copy Markdown
Contributor

@cameroncooke cameroncooke commented Apr 30, 2026

Document the new Size Analysis status check rules API for external CI consumers. The docs explain how to fetch the current rule configuration, how to interpret thresholds, and how the machine-readable filter response maps to Sentry's runtime rule evaluation.

Filter Semantics

The page now calls out that separate filter objects are ANDed, conditions inside a filter are ORed, and same-key positive and negative groups can both appear. It also documents filters: [] versus filters: null, in/notIn, decoded literal values, missing metadata behavior, and artifact type mapping.

API Reference Preview Note

This PR links the Size Analysis CI guide to the generated API reference page:

/api/mobile-builds/retrieve-size-analysis-status-check-rules-for-a-project/

That page is generated from the Sentry OpenAPI schema, so it may 404 in this docs preview until the companion Sentry PR lands and the updated schema is published/bumped in sentry-docs.

Local Preview Instructions

To preview the generated API reference page locally before the schema cascade lands:

  1. In the sentry repo, check out the companion Sentry branch unless the Sentry PR has already landed in master:

    cd /Volumes/Developer/sentry
    git checkout cameroncooke/feat/eme-1061-size-status-rules-api
  2. Generate the OpenAPI schema from that Sentry branch:

    PATH="$PWD/.venv/bin:$PATH" make build-api-docs

    This writes the local schema to:

    /Volumes/Developer/sentry/tests/apidocs/openapi-derefed.json
    
  3. In the sentry-docs repo, run the dev server with that local schema:

    cd /Volumes/Developer/sentry-docs
    OPENAPI_LOCAL_PATH=/Volumes/Developer/sentry/tests/apidocs/openapi-derefed.json \
    DISABLE_THUMBNAILS=1 \
    pnpm dev
  4. Open the generated endpoint page:

    http://localhost:3000/api/mobile-builds/retrieve-size-analysis-status-check-rules-for-a-project/
    

Refs EME-1061

@linear-code
Copy link
Copy Markdown

linear-code Bot commented Apr 30, 2026

@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 30, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
sentry-docs Ready Ready Preview, Comment Apr 30, 2026 2:05pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
develop-docs Ignored Ignored Preview Apr 30, 2026 2:05pm

Request Review

Document how external CI consumers can fetch Size Analysis status check rules and interpret the machine-readable filter response.

Cover filter grouping semantics, decoded literal values, invalid filter handling, and artifact type mapping.

Refs EME-1061

Co-Authored-By: OpenAI Codex <noreply@openai.com>
@cameroncooke cameroncooke force-pushed the cameroncooke/docs/eme-1061-size-status-rules-api branch from 8ba1209 to b5d91be Compare April 30, 2026 12:46
@cameroncooke cameroncooke marked this pull request as ready for review April 30, 2026 12:47
@cameroncooke cameroncooke requested a review from mtopo27 April 30, 2026 13:22
Comment thread docs/product/size-analysis/integrating-into-ci.mdx Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants