Skip to content

docs(feature-flags): add clear_feature_flags scope API spec (1.0.2)#18660

Open
romtsn wants to merge 3 commits into
masterfrom
sdk/feature-flags-clear-api
Open

docs(feature-flags): add clear_feature_flags scope API spec (1.0.2)#18660
romtsn wants to merge 3 commits into
masterfrom
sdk/feature-flags-clear-api

Conversation

@romtsn

@romtsn romtsn commented Jul 7, 2026

Copy link
Copy Markdown
Member

DESCRIBE YOUR PR

Adds a clear_feature_flags scope API section to the Feature Flags SDK spec, bumping the spec to 1.0.2.

What changed

  • New SpecSection documenting the clear_feature_flags API on scope
  • API is MAY (optional): SDKs may expose it; when they do, it MUST clear all feature flag evaluations on the current scope without affecting parent/sibling scopes
  • Spec version bumped 1.0.1 → 1.0.2 with changelog entry

Why

This surfaced during sentry-cocoa feature flag work (getsentry/sentry-cocoa#8364). sentry-java already ships this API (JAVA-512). Cocoa is aligning with Java, and the spec had no entry for it, leading to inconsistency across SDKs. The Slack thread in #team-sdks confirmed the team wants this as a scope-level API (not on spans) to help users — particularly those running large numbers of experiments — discard stale evaluations before capturing an error event.

Verified

Content consistency review: frontmatter spec version and changelog entry are consistent; RFC 2119 keywords are uppercase and bold per AGENTS.md; SpecSection id/status/since attributes follow existing patterns.

IS YOUR CHANGE URGENT?

  • None: Not urgent, can wait up to 1 week+

PRE-MERGE CHECKLIST

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs (subject matter experts)
  • PR was reviewed and approved by a member of the Sentry docs team

--

View Junior Session in Sentry

Co-Authored-By: sentry-junior[bot] <264270552+sentry-junior[bot]@users.noreply.github.com>
@vercel

vercel Bot commented Jul 7, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
develop-docs Ready Ready Preview, Comment Jul 7, 2026 3:21pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
sentry-docs Ignored Ignored Preview Jul 7, 2026 3:21pm

Request Review

Co-Authored-By: sentry-junior[bot] <264270552+sentry-junior[bot]@users.noreply.github.com>
@romtsn romtsn marked this pull request as ready for review July 7, 2026 15:47
@romtsn romtsn requested a review from cleptric July 7, 2026 16:05

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we make it clear that all exposed functions mentioned on this page should be exposed on the scope?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

sdk-develop-docs PRs touching develop-docs/sdk

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants