Skip to content

docs(feature-flags): Document Apple, Java, and Android APIs#18755

Merged
denrase merged 6 commits into
masterfrom
denrase/cocoa-feature-flags
Jul 27, 2026
Merged

docs(feature-flags): Document Apple, Java, and Android APIs#18755
denrase merged 6 commits into
masterfrom
denrase/cocoa-feature-flags

Conversation

@denrase

@denrase denrase commented Jul 17, 2026

Copy link
Copy Markdown
Collaborator

DESCRIBE YOUR PR

Tell us what you're changing and why. If your PR resolves an issue, please link it so it closes automatically.

Add feature flag evaluation tracking documentation for the Apple SDK and expand the Java and Android guides.

The guides cover the generic API, custom scopes and hubs, scope callbacks, clearing evaluations, span attributes, retention limits, and scope isolation. They also document minimum SDK versions and link all supported platforms from the product documentation.

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.

  • Urgent deadline (GA date, etc.):
  • Other deadline:
  • None: Not urgent, can wait up to 1 week+

SLA

  • Teamwork makes the dream work, so please add a reviewer to your PRs.
  • Please give the docs team up to 1 week to review your PR unless you've added an urgent due date to it.
    Thanks in advance for your help!

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

  • 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

EXTRA RESOURCES

Closes getsentry/sentry-cocoa#8159

denrase added 2 commits July 17, 2026 11:46
Add feature flag evaluation tracking documentation for the Apple SDK and expand the Java and Android guides.

The guides cover the generic API, custom scopes and hubs, scope callbacks, clearing evaluations, span attributes, retention limits, and scope isolation. They also document minimum SDK versions and link all supported platforms from the product documentation.
@vercel

vercel Bot commented Jul 17, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
sentry-docs Ready Ready Preview Jul 27, 2026 7:59am
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
develop-docs Ignored Ignored Preview Jul 27, 2026 7:59am

Request Review

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Adds/expands Feature Flag evaluation tracking documentation for Apple, Java, and Android SDKs, and updates the product “Issue Details > Feature Flags” page to link to all supported platform guides.

Changes:

  • Expand Java + Android evaluation-tracking includes with guidance for custom IScopes, scope callbacks, and clearing evaluations, plus documented retention/attachment behavior.
  • Add new Apple evaluation-tracking include and a new Apple “Set Up Feature Flags” platform page, and surface Feature Flags in the Apple “Features” list.
  • Update the product feature flags docs to link to additional platform setup pages and reformat the change-tracking include for consistency.

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
platform-includes/feature-flags/evaluation-tracking-index/java.mdx Expands Java evaluation-tracking docs (generic API + scopes/callbacks/clearing + limits).
platform-includes/feature-flags/evaluation-tracking-index/android.mdx Mirrors the Java expansion for Android evaluation-tracking docs.
platform-includes/feature-flags/evaluation-tracking-index/apple.mdx Introduces Apple evaluation-tracking API docs (Swift + ObjC).
docs/product/issues/issue-details/feature-flags/index.mdx Adds platform setup links (Android/Apple/etc.) and formats change-tracking include.
docs/platforms/java/common/feature-flags/index.mdx Adds minimum Java SDK version prerequisite and trims trailing whitespace.
docs/platforms/android/feature-flags/index.mdx Adds minimum Android SDK version prerequisite and trims trailing whitespace.
docs/platforms/apple/common/features/index.mdx Adds Feature Flags to the Apple “Features” list.
docs/platforms/apple/common/feature-flags/index.mdx New Apple Feature Flags setup page (prereqs + evaluation/change tracking includes).

Comment thread platform-includes/feature-flags/evaluation-tracking-index/java.mdx Outdated
Comment thread platform-includes/feature-flags/evaluation-tracking-index/android.mdx Outdated
Comment thread platform-includes/feature-flags/evaluation-tracking-index/apple.mdx Outdated

@philprime philprime left a comment

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.

Apple related docs look good to me. Left comments to consider

Comment thread docs/platforms/apple/common/feature-flags/index.mdx
Comment thread platform-includes/feature-flags/evaluation-tracking-index/android.mdx Outdated
@codeowner-assignment
codeowner-assignment Bot requested a review from a team July 27, 2026 07:38

@romtsn romtsn left a comment

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.

LGTM!

@denrase
denrase merged commit 38afaca into master Jul 27, 2026
22 checks passed
@denrase
denrase deleted the denrase/cocoa-feature-flags branch July 27, 2026 08:53
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.

Docs for new manual APIs

6 participants