Skip to content

chore(android): Update feedback docs to use new Sentry.feedback() API#17631

Open
romtsn wants to merge 3 commits intomasterfrom
rz/chore/feedback-api-docs
Open

chore(android): Update feedback docs to use new Sentry.feedback() API#17631
romtsn wants to merge 3 commits intomasterfrom
rz/chore/feedback-api-docs

Conversation

@romtsn
Copy link
Copy Markdown
Member

@romtsn romtsn commented May 5, 2026

Switch all Android user feedback documentation from the old showUserFeedbackDialog/captureFeedback APIs to the new Sentry.feedback().show() and Sentry.feedback().capture() entry points. Drop the SentryUserFeedbackButton widget section and rename SentryUserFeedbackDialog references to SentryUserFeedbackForm.

New API examples

All code examples now use Sentry.feedback() as the entry point — show() for displaying the built-in form and capture() for submitting feedback from custom UI.

Builder-based custom form

Added a "Custom Form" subsection showing SentryUserFeedbackForm.Builder for full control over theme, associated event, and per-form options.

Per-form shake-to-show

Added documentation for enabling shake detection on individual form instances via Builder.configurator { it.isUseShakeGesture = true }, as an alternative to the global shake setting.

Depends on getsentry/sentry-java#5353 and getsentry/sentry-java#5366.

Closes getsentry/sentry-java#5306

Switch all Android user feedback examples from the old
showUserFeedbackDialog/captureFeedback APIs to the new
Sentry.feedback().show() and Sentry.feedback().capture() entry points.
Drop the SentryUserFeedbackButton widget section entirely and add
Builder-based custom form and per-form shake-to-show documentation.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented May 5, 2026

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

Project Deployment Actions Updated (UTC)
sentry-docs Ready Ready Preview, Comment May 6, 2026 8:07am
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
develop-docs Ignored Ignored Preview May 6, 2026 8:07am

Request Review

@codeowner-assignment codeowner-assignment Bot requested a review from a team May 5, 2026 20:34
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Comment on lines 1 to 3
```kotlin {tabTitle:Kotlin}
import io.sentry.Sentry
import io.sentry.protocol.Feedback
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Bug: The Java SDK documentation for user feedback incorrectly defaults to showing a Kotlin code example instead of Java due to reordered code blocks.
Severity: LOW

Suggested Fix

In platform-includes/user-feedback/sdk-api-example/java.mdx, restore the original order of the code blocks by placing the Java snippet before the Kotlin snippet. This will ensure the Java code is the default view on the Java documentation page.

Prompt for AI Agent
Review the code at the location below. A potential bug has been identified by an AI
agent. Verify if this is a real issue. If it is, propose a fix; if not, explain why it's
not valid.

Location: platform-includes/user-feedback/sdk-api-example/java.mdx#L1-L3

Potential issue: A change intended to reorder code snippets for Android documentation
has unintentionally altered the
`platform-includes/user-feedback/sdk-api-example/java.mdx` file. This file is used in
the pure Java SDK documentation. As a result, the Kotlin code example is now displayed
by default on the Java documentation page for user feedback, which can be confusing for
users seeking Java-specific code.

Did we get this right? 👍 / 👎 to inform future reviews.

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.

Feedback: Update documentation

1 participant