From 0d10c959e3a1de597b6698267198ccf8dcf0b135 Mon Sep 17 00:00:00 2001
From: Nelson Osacky <nelson.osacky@sentry.io>
Date: Mon, 26 Jan 2026 13:13:22 +0100
Subject: [PATCH 1/4] ref(docs): Use dynamic version for Android Gradle plugin
 in upload instructions (EME-758)

Replace hardcoded version (6.0.0-rc.1) with dynamic version fetched from
package registry. This ensures the docs always show the latest available
version for size analysis and build distribution features.

Co-Authored-By: Claude <noreply@anthropic.com>
---
 src/components/gradleUploadInstructions.tsx | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/src/components/gradleUploadInstructions.tsx b/src/components/gradleUploadInstructions.tsx
index 0c4db95c491d6b..1c99a24b32b0c9 100644
--- a/src/components/gradleUploadInstructions.tsx
+++ b/src/components/gradleUploadInstructions.tsx
@@ -2,6 +2,8 @@ import {Fragment} from 'react';
 import Image from 'next/image';
 import Link from 'next/link';
 
+import getPackageRegistry from 'sentry-docs/build/packageRegistry';
+
 import {CodeBlock} from './codeBlock';
 import {CodeTabs} from './codeTabs';
 import {GradleFeatureConfig} from './gradleFeatureConfig';
@@ -12,9 +14,13 @@ type Props = {
   feature: 'sizeAnalysis' | 'distribution';
 };
 
-export function GradleUploadInstructions({feature}: Props) {
+export async function GradleUploadInstructions({feature}: Props) {
   const featureName = feature === 'sizeAnalysis' ? 'size analysis' : 'distribution';
 
+  const packageRegistry = await getPackageRegistry();
+  const gradlePluginVersion =
+    packageRegistry.data['sentry.java.android.gradle-plugin']?.version || '6.0.0';
+
   return (
     <Fragment>
       <p>
@@ -29,7 +35,7 @@ export function GradleUploadInstructions({feature}: Props) {
           <Link href="/platforms/android/configuration/gradle/">
             Sentry Android Gradle plugin
           </Link>{' '}
-          with at least version <code>6.0.0-rc.1</code>
+          with at least version <code>{gradlePluginVersion}</code>
         </li>
 
         <li>

From 170dca73eb3faaec99a65966691ae82129a7be88 Mon Sep 17 00:00:00 2001
From: Nelson Osacky <nelson.osacky@sentry.io>
Date: Mon, 26 Jan 2026 13:36:27 +0100
Subject: [PATCH 2/4] Fix: Add null check for packageRegistry.data

Use optional chaining to handle case where packageRegistry.data might be null,
consistent with other components like PlatformSdkDetail and JsBundleList.

Co-Authored-By: Claude <noreply@anthropic.com>
---
 src/components/gradleUploadInstructions.tsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/components/gradleUploadInstructions.tsx b/src/components/gradleUploadInstructions.tsx
index 1c99a24b32b0c9..c7496a9a8e8b37 100644
--- a/src/components/gradleUploadInstructions.tsx
+++ b/src/components/gradleUploadInstructions.tsx
@@ -19,7 +19,7 @@ export async function GradleUploadInstructions({feature}: Props) {
 
   const packageRegistry = await getPackageRegistry();
   const gradlePluginVersion =
-    packageRegistry.data['sentry.java.android.gradle-plugin']?.version || '6.0.0';
+    packageRegistry.data?.['sentry.java.android.gradle-plugin']?.version || '6.0.0';
 
   return (
     <Fragment>

From 4e51b6b5c8cb347e05fb61eaf650bcb32cba58cb Mon Sep 17 00:00:00 2001
From: Nelson Osacky <nelson.osacky@sentry.io>
Date: Tue, 27 Jan 2026 09:42:15 +0100
Subject: [PATCH 3/4] ref(docs): Add cache invalidation for
 GradleUploadInstructions (EME-758)

Adds GradleUploadInstructions to the registry dependency detection in
mdx.ts so that MDX files using this component are properly cache
invalidated when the Release Registry data changes.

Also updates the fallback version to 7.12.3 for testing.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
---
 src/components/gradleUploadInstructions.tsx | 2 +-
 src/mdx.ts                                  | 3 ++-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/components/gradleUploadInstructions.tsx b/src/components/gradleUploadInstructions.tsx
index c7496a9a8e8b37..138c8f7b80a0e2 100644
--- a/src/components/gradleUploadInstructions.tsx
+++ b/src/components/gradleUploadInstructions.tsx
@@ -19,7 +19,7 @@ export async function GradleUploadInstructions({feature}: Props) {
 
   const packageRegistry = await getPackageRegistry();
   const gradlePluginVersion =
-    packageRegistry.data?.['sentry.java.android.gradle-plugin']?.version || '6.0.0';
+    packageRegistry.data?.['sentry.java.android.gradle-plugin']?.version || '7.12.3';
 
   return (
     <Fragment>
diff --git a/src/mdx.ts b/src/mdx.ts
index 62d0d434821ad8..5a3087cfbe91f0 100644
--- a/src/mdx.ts
+++ b/src/mdx.ts
@@ -669,7 +669,8 @@ export async function getFileBySlug(slug: string): Promise<SlugFile> {
   const dependsOnRegistry =
     source.includes('@inject') ||
     source.includes('<PlatformSDKPackageName') ||
-    source.includes('<LambdaLayerDetail');
+    source.includes('<LambdaLayerDetail') ||
+    source.includes('<GradleUploadInstructions');
 
   // Check cache in CI environments
   if (process.env.CI) {

From 9e2e0130e5b7071eb68b7814de0e3518ca14ef39 Mon Sep 17 00:00:00 2001
From: Nelson Osacky <nelson.osacky@sentry.io>
Date: Tue, 27 Jan 2026 09:44:35 +0100
Subject: [PATCH 4/4] ref(docs): Revert fallback version to 6.0.0 (EME-758)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
---
 src/components/gradleUploadInstructions.tsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/components/gradleUploadInstructions.tsx b/src/components/gradleUploadInstructions.tsx
index 138c8f7b80a0e2..c7496a9a8e8b37 100644
--- a/src/components/gradleUploadInstructions.tsx
+++ b/src/components/gradleUploadInstructions.tsx
@@ -19,7 +19,7 @@ export async function GradleUploadInstructions({feature}: Props) {
 
   const packageRegistry = await getPackageRegistry();
   const gradlePluginVersion =
-    packageRegistry.data?.['sentry.java.android.gradle-plugin']?.version || '7.12.3';
+    packageRegistry.data?.['sentry.java.android.gradle-plugin']?.version || '6.0.0';
 
   return (
     <Fragment>