From f9f79cec39be0d9e0c2268c061e341fc8d654799 Mon Sep 17 00:00:00 2001
From: Max Topolsky <30879163+mtopo27@users.noreply.github.com>
Date: Thu, 26 Mar 2026 16:29:33 -0700
Subject: [PATCH] feat(monitors): Add info hint for diff-based issue detection

Show a subtle inline hint when Absolute Diff or Relative Diff is selected,
explaining that comparisons use the previous build matching the monitor's
filters, platform, package_name, and build_configuration.

Co-Authored-By: Claude Opus 4.6 <noreply@example.com>
---
 .../forms/mobileBuild/detectSection.tsx       | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/static/app/views/detectors/components/forms/mobileBuild/detectSection.tsx b/static/app/views/detectors/components/forms/mobileBuild/detectSection.tsx
index c6218ea03e6c02..2279e853ddcd27 100644
--- a/static/app/views/detectors/components/forms/mobileBuild/detectSection.tsx
+++ b/static/app/views/detectors/components/forms/mobileBuild/detectSection.tsx
@@ -1,13 +1,15 @@
 import {Fragment, useMemo} from 'react';
 import styled from '@emotion/styled';
 
+import {InlineCode} from '@sentry/scraps/code';
 import {Flex, Stack} from '@sentry/scraps/layout';
 import {Heading, Text} from '@sentry/scraps/text';
 
 import {NumberField} from 'sentry/components/forms/fields/numberField';
 import {SegmentedRadioField} from 'sentry/components/forms/fields/segmentedRadioField';
 import {Container} from 'sentry/components/workflowEngine/ui/container';
-import {t} from 'sentry/locale';
+import {IconInfo} from 'sentry/icons';
+import {t, tct} from 'sentry/locale';
 import {
   DETECTOR_PRIORITY_LEVEL_TO_PRIORITY_LEVEL,
   DetectorPriorityLevel,
@@ -79,6 +81,21 @@ export function MobileBuildDetectSection() {
               flexibleControlStateSize
               preserveOnUnmount
             />
+            {(thresholdType === 'absolute_diff' || thresholdType === 'relative_diff') && (
+              <Flex align="center" gap="sm">
+                <IconInfo size="xs" />
+                <Text variant="muted" size="sm">
+                  {tct(
+                    "Compares against the previous build matching this monitor's filters, [platform], [packageName], and [buildConfiguration].",
+                    {
+                      platform: <InlineCode>platform</InlineCode>,
+                      packageName: <InlineCode>package_name</InlineCode>,
+                      buildConfiguration: <InlineCode>build_configuration</InlineCode>,
+                    }
+                  )}
+                </Text>
+              </Flex>
+            )}
           </section>
 
           <ThresholdSection thresholdType={thresholdType} />