From 9d5fbbee9ef5a5c89fb699bd74e60d775b3824ce Mon Sep 17 00:00:00 2001
From: lcian <lorenzo.cian@sentry.io>
Date: Tue, 18 Feb 2025 17:24:43 +0100
Subject: [PATCH 1/4] ref(java): add Maven plugin to Java guides

---
 .../java/common/integrations/graphql.mdx      | 10 +++++++++
 .../java/common/integrations/graphql22.mdx    | 10 +++++++++
 .../java/common/integrations/quartz.mdx       | 10 +++++++++
 .../getting-started-install/java.log4j2.mdx   | 14 +++++++-----
 .../getting-started-install/java.logback.mdx  | 14 +++++++-----
 .../getting-started-install/java.mdx          | 14 +++++++-----
 .../java.spring-boot.mdx                      | 22 +++++++------------
 .../getting-started-install/java.spring.mdx   | 22 +++++++------------
 8 files changed, 70 insertions(+), 46 deletions(-)

diff --git a/docs/platforms/java/common/integrations/graphql.mdx b/docs/platforms/java/common/integrations/graphql.mdx
index d9867c203bf22..2eef510186392 100644
--- a/docs/platforms/java/common/integrations/graphql.mdx
+++ b/docs/platforms/java/common/integrations/graphql.mdx
@@ -34,6 +34,16 @@ plugins {
 implementation 'io.sentry:sentry-graphql:{{@inject packages.version('sentry.java.graphql', '6.28.0') }}'
 ```
 
+```xml {tabTitle:Maven Plugin}{filename:pom.xml}
+<plugin>
+  <groupId>io.sentry</groupId>
+  <artifactId>sentry-maven-plugin</artifactId>
+  <version>{{@inject packages.version('sentry.java.maven-plugin', '0.0.2') }}</version>
+  <!-- Required to allow auto-install of Sentry SDK and Integrations -->
+  <extensions>true</extensions>
+</plugin>
+```
+
 ```xml {tabTitle:Maven}
 <dependency>
     <groupId>io.sentry</groupId>
diff --git a/docs/platforms/java/common/integrations/graphql22.mdx b/docs/platforms/java/common/integrations/graphql22.mdx
index 24d06a8b83610..784d1dfc60151 100644
--- a/docs/platforms/java/common/integrations/graphql22.mdx
+++ b/docs/platforms/java/common/integrations/graphql22.mdx
@@ -34,6 +34,16 @@ plugins {
 implementation 'io.sentry:sentry-graphql-22:{{@inject packages.version('sentry.java.graphql-22', '8.0.0') }}'
 ```
 
+```xml {tabTitle:Maven Plugin}{filename:pom.xml}
+<plugin>
+  <groupId>io.sentry</groupId>
+  <artifactId>sentry-maven-plugin</artifactId>
+  <version>{{@inject packages.version('sentry.java.maven-plugin', '0.0.2') }}</version>
+  <!-- Required to allow auto-install of Sentry SDK and Integrations -->
+  <extensions>true</extensions>
+</plugin>
+```
+
 ```xml {tabTitle:Maven}
 <dependency>
     <groupId>io.sentry</groupId>
diff --git a/docs/platforms/java/common/integrations/quartz.mdx b/docs/platforms/java/common/integrations/quartz.mdx
index 32e6f49cbbf6c..f025d0c8249c2 100644
--- a/docs/platforms/java/common/integrations/quartz.mdx
+++ b/docs/platforms/java/common/integrations/quartz.mdx
@@ -23,6 +23,16 @@ plugins {
 implementation 'io.sentry:sentry-quartz:{{@inject packages.version('sentry.java.quartz', '6.30.0') }}'
 ```
 
+```xml {tabTitle:Maven Plugin}{filename:pom.xml}
+<plugin>
+  <groupId>io.sentry</groupId>
+  <artifactId>sentry-maven-plugin</artifactId>
+  <version>{{@inject packages.version('sentry.java.maven-plugin', '0.0.2') }}</version>
+  <!-- Required to allow auto-install of Sentry SDK and Integrations -->
+  <extensions>true</extensions>
+</plugin>
+```
+
 ```xml {tabTitle:Maven}
 <dependency>
     <groupId>io.sentry</groupId>
diff --git a/platform-includes/getting-started-install/java.log4j2.mdx b/platform-includes/getting-started-install/java.log4j2.mdx
index fe53fa47cdb28..a2504c7539f32 100644
--- a/platform-includes/getting-started-install/java.log4j2.mdx
+++ b/platform-includes/getting-started-install/java.log4j2.mdx
@@ -2,12 +2,14 @@
   options={["error-monitoring", "performance", "opentelemetry"]}
 />
 
-```xml {tabTitle:Maven}
-<dependency>
-    <groupId>io.sentry</groupId>
-    <artifactId>sentry-log4j2</artifactId>
-    <version>{{@inject packages.version('sentry.java.log4j2', '4.2.0') }}</version>
-</dependency>
+```xml {tabTitle:Maven Plugin}{filename:pom.xml}
+<plugin>
+  <groupId>io.sentry</groupId>
+  <artifactId>sentry-maven-plugin</artifactId>
+  <version>{{@inject packages.version('sentry.java.maven-plugin', '0.0.2') }}</version>
+  <!-- Required to allow auto-install of Sentry SDK and Integrations -->
+  <extensions>true</extensions>
+</plugin>
 ```
 
 ```groovy {tabTitle:Gradle Plugin}
diff --git a/platform-includes/getting-started-install/java.logback.mdx b/platform-includes/getting-started-install/java.logback.mdx
index e267a1c74af0b..74639f4f70f9b 100644
--- a/platform-includes/getting-started-install/java.logback.mdx
+++ b/platform-includes/getting-started-install/java.logback.mdx
@@ -2,12 +2,14 @@
   options={["error-monitoring", "performance", "opentelemetry"]}
 />
 
-```xml {tabTitle:Maven}
-<dependency>
-    <groupId>io.sentry</groupId>
-    <artifactId>sentry-logback</artifactId>
-    <version>{{@inject packages.version('sentry.java.logback', '4.2.0') }}</version>
-</dependency>
+```xml {tabTitle:Maven Plugin}{filename:pom.xml}
+<plugin>
+  <groupId>io.sentry</groupId>
+  <artifactId>sentry-maven-plugin</artifactId>
+  <version>{{@inject packages.version('sentry.java.maven-plugin', '0.0.2') }}</version>
+  <!-- Required to allow auto-install of Sentry SDK and Integrations -->
+  <extensions>true</extensions>
+</plugin>
 ```
 
 ```groovy {tabTitle:Gradle Plugin}
diff --git a/platform-includes/getting-started-install/java.mdx b/platform-includes/getting-started-install/java.mdx
index b5725503b1a2d..3fd9b34d76e0e 100644
--- a/platform-includes/getting-started-install/java.mdx
+++ b/platform-includes/getting-started-install/java.mdx
@@ -8,12 +8,14 @@ plugins {
 }
 ```
 
-```xml {tabTitle:Maven}{filename:pom.xml}
-<dependency>
-    <groupId>io.sentry</groupId>
-    <artifactId>sentry</artifactId>
-    <version>{{@inject packages.version('sentry.java', '4.2.0') }}</version>
-</dependency>
+```xml {tabTitle:Maven Plugin}{filename:pom.xml}
+<plugin>
+  <groupId>io.sentry</groupId>
+  <artifactId>sentry-maven-plugin</artifactId>
+  <version>{{@inject packages.version('sentry.java.maven-plugin', '0.0.2') }}</version>
+  <!-- Required to allow auto-install of Sentry SDK and Integrations -->
+  <extensions>true</extensions>
+</plugin>
 ```
 
 ```scala {tabTitle:SBT}
diff --git a/platform-includes/getting-started-install/java.spring-boot.mdx b/platform-includes/getting-started-install/java.spring-boot.mdx
index 0c7db852f4e86..8d46334e37e91 100644
--- a/platform-includes/getting-started-install/java.spring-boot.mdx
+++ b/platform-includes/getting-started-install/java.spring-boot.mdx
@@ -8,20 +8,14 @@ plugins {
 }
 ```
 
-```xml {tabTitle:Maven (Spring Boot 2)}
-<dependency>
-    <groupId>io.sentry</groupId>
-    <artifactId>sentry-spring-boot-starter</artifactId>
-    <version>{{@inject packages.version('sentry.java.spring-boot', '4.2.0') }}</version>
-</dependency>
-```
-
-```xml {tabTitle:Maven (Spring Boot 3)}
-<dependency>
-    <groupId>io.sentry</groupId>
-    <artifactId>sentry-spring-boot-starter-jakarta</artifactId>
-    <version>{{@inject packages.version('sentry.java.spring-boot.jakarta', '6.7.0') }}</version>
-</dependency>
+```xml {tabTitle:Maven Plugin}{filename:pom.xml}
+<plugin>
+  <groupId>io.sentry</groupId>
+  <artifactId>sentry-maven-plugin</artifactId>
+  <version>{{@inject packages.version('sentry.java.maven-plugin', '0.0.2') }}</version>
+  <!-- Required to allow auto-install of Sentry SDK and Integrations -->
+  <extensions>true</extensions>
+</plugin>
 ```
 
 ```groovy {tabTitle:Gradle (Spring Boot 2)}
diff --git a/platform-includes/getting-started-install/java.spring.mdx b/platform-includes/getting-started-install/java.spring.mdx
index d1a2b3a07ea63..c3ecb692f5309 100644
--- a/platform-includes/getting-started-install/java.spring.mdx
+++ b/platform-includes/getting-started-install/java.spring.mdx
@@ -8,20 +8,14 @@ plugins {
 }
 ```
 
-```xml {tabTitle:Maven (Spring 5)}
-<dependency>
-    <groupId>io.sentry</groupId>
-    <artifactId>sentry-spring</artifactId>
-    <version>{{@inject packages.version('sentry.java.spring', '4.2.0') }}</version>
-</dependency>
-```
-
-```xml {tabTitle:Maven (Spring 6)}
-<dependency>
-    <groupId>io.sentry</groupId>
-    <artifactId>sentry-spring-jakarta</artifactId>
-    <version>{{@inject packages.version('sentry.java.spring.jakarta', '6.7.0') }}</version>
-</dependency>
+```xml {tabTitle:Maven Plugin}{filename:pom.xml}
+<plugin>
+  <groupId>io.sentry</groupId>
+  <artifactId>sentry-maven-plugin</artifactId>
+  <version>{{@inject packages.version('sentry.java.maven-plugin', '0.0.2') }}</version>
+  <!-- Required to allow auto-install of Sentry SDK and Integrations -->
+  <extensions>true</extensions>
+</plugin>
 ```
 
 ```groovy {tabTitle:Gradle (Spring 5)}

From de726c41a7c49af43f1b17db9d06c2736664f32e Mon Sep 17 00:00:00 2001
From: lcian <lorenzo.cian@sentry.io>
Date: Thu, 20 Feb 2025 16:43:35 +0100
Subject: [PATCH 2/4] address comments

---
 .../getting-started-install/java.log4j2.mdx   | 29 +++++++++++++++
 .../getting-started-install/java.logback.mdx  | 29 +++++++++++++++
 .../getting-started-install/java.mdx          | 21 +++++++++++
 .../java.spring-boot.mdx                      | 21 +++++++++++
 .../getting-started-install/java.spring.mdx   | 37 +++++++++++++++++++
 5 files changed, 137 insertions(+)

diff --git a/platform-includes/getting-started-install/java.log4j2.mdx b/platform-includes/getting-started-install/java.log4j2.mdx
index a2504c7539f32..5486e82e4a6e0 100644
--- a/platform-includes/getting-started-install/java.log4j2.mdx
+++ b/platform-includes/getting-started-install/java.log4j2.mdx
@@ -9,9 +9,38 @@
   <version>{{@inject packages.version('sentry.java.maven-plugin', '0.0.2') }}</version>
   <!-- Required to allow auto-install of Sentry SDK and Integrations -->
   <extensions>true</extensions>
+  <configuration>
+    <!-- In case you're self hosting, provide the URL here -->
+    <!-- <url>http://localhost:8000/</url> -->
+    <org>___SENTRY_ORG_SLUG___</org>
+    <project>___SENTRY_PROJECT_SLUG___</project>
+    <!-- Do not commit you auth token with this file, you should provide it via the SENTRY_AUTH_TOKEN environment variable or similar -->
+    <!-- <authToken>${env.SENTRY_AUTH_TOKEN}</authToken> -->
+    <authToken>___SENTRY_AUTH_TOKEN___</authToken>
+    <!-- Enable debugging to see logs in case something goes wrong when uploading the source bundle -->
+    <debugSentryCli>true</debugSentryCli>
+   </configuration>
+   <executions>
+    <execution>
+      <goals>
+        <!-- Generates a source bundle and uploads it to Sentry -->
+        <!-- This enables source context, allowing you to see your source code as part of your stack traces in Sentry -->
+        <!-- Learn more about this feature in its dedicated "Source Context" docs page -->
+        <goal>uploadSourceBundle</goal>
+      </goals>
+    </execution>
+  </executions>
 </plugin>
 ```
 
+```xml {tabTitle:Maven}
+<dependency>
+    <groupId>io.sentry</groupId>
+    <artifactId>sentry-log4j2</artifactId>
+    <version>{{@inject packages.version('sentry.java.log4j2', '4.2.0') }}</version>
+</dependency>
+```
+
 ```groovy {tabTitle:Gradle Plugin}
 plugins {
   id "io.sentry.jvm.gradle" version "{{@inject packages.version('sentry.java.android.gradle-plugin', '3.12.0') }}"
diff --git a/platform-includes/getting-started-install/java.logback.mdx b/platform-includes/getting-started-install/java.logback.mdx
index 74639f4f70f9b..f747fd37e0200 100644
--- a/platform-includes/getting-started-install/java.logback.mdx
+++ b/platform-includes/getting-started-install/java.logback.mdx
@@ -9,9 +9,38 @@
   <version>{{@inject packages.version('sentry.java.maven-plugin', '0.0.2') }}</version>
   <!-- Required to allow auto-install of Sentry SDK and Integrations -->
   <extensions>true</extensions>
+  <configuration>
+    <!-- In case you're self hosting, provide the URL here -->
+    <!-- <url>http://localhost:8000/</url> -->
+    <org>___SENTRY_ORG_SLUG___</org>
+    <project>___SENTRY_PROJECT_SLUG___</project>
+    <!-- Do not commit you auth token with this file, you should provide it via the SENTRY_AUTH_TOKEN environment variable or similar -->
+    <!-- <authToken>${env.SENTRY_AUTH_TOKEN}</authToken> -->
+    <authToken>___SENTRY_AUTH_TOKEN___</authToken>
+    <!-- Enable debugging to see logs in case something goes wrong when uploading the source bundle -->
+    <debugSentryCli>true</debugSentryCli>
+   </configuration>
+   <executions>
+    <execution>
+      <goals>
+        <!-- Generates a source bundle and uploads it to Sentry -->
+        <!-- This enables source context, allowing you to see your source code as part of your stack traces in Sentry -->
+        <!-- Learn more about this feature in its dedicated "Source Context" docs page -->
+        <goal>uploadSourceBundle</goal>
+      </goals>
+    </execution>
+  </executions>
 </plugin>
 ```
 
+```xml {tabTitle:Maven}
+<dependency>
+    <groupId>io.sentry</groupId>
+    <artifactId>sentry-logback</artifactId>
+    <version>{{@inject packages.version('sentry.java.logback', '4.2.0') }}</version>
+</dependency>
+```
+
 ```groovy {tabTitle:Gradle Plugin}
 plugins {
   id "io.sentry.jvm.gradle" version "{{@inject packages.version('sentry.java.android.gradle-plugin', '3.12.0') }}"
diff --git a/platform-includes/getting-started-install/java.mdx b/platform-includes/getting-started-install/java.mdx
index 3fd9b34d76e0e..97456c934b291 100644
--- a/platform-includes/getting-started-install/java.mdx
+++ b/platform-includes/getting-started-install/java.mdx
@@ -15,6 +15,27 @@ plugins {
   <version>{{@inject packages.version('sentry.java.maven-plugin', '0.0.2') }}</version>
   <!-- Required to allow auto-install of Sentry SDK and Integrations -->
   <extensions>true</extensions>
+  <configuration>
+    <!-- In case you're self hosting, provide the URL here -->
+    <!-- <url>http://localhost:8000/</url> -->
+    <org>___SENTRY_ORG_SLUG___</org>
+    <project>___SENTRY_PROJECT_SLUG___</project>
+    <!-- Do not commit you auth token with this file, you should provide it via the SENTRY_AUTH_TOKEN environment variable or similar -->
+    <!-- <authToken>${env.SENTRY_AUTH_TOKEN}</authToken> -->
+    <authToken>___SENTRY_AUTH_TOKEN___</authToken>
+    <!-- Enable debugging to see logs in case something goes wrong when uploading the source bundle -->
+    <debugSentryCli>true</debugSentryCli>
+   </configuration>
+   <executions>
+    <execution>
+      <goals>
+        <!-- Generates a source bundle and uploads it to Sentry -->
+        <!-- This enables source context, allowing you to see your source code as part of your stack traces in Sentry -->
+        <!-- Learn more about this feature in its dedicated "Source Context" docs page -->
+        <goal>uploadSourceBundle</goal>
+      </goals>
+    </execution>
+  </executions>
 </plugin>
 ```
 
diff --git a/platform-includes/getting-started-install/java.spring-boot.mdx b/platform-includes/getting-started-install/java.spring-boot.mdx
index 8d46334e37e91..397d3c1094e08 100644
--- a/platform-includes/getting-started-install/java.spring-boot.mdx
+++ b/platform-includes/getting-started-install/java.spring-boot.mdx
@@ -15,6 +15,27 @@ plugins {
   <version>{{@inject packages.version('sentry.java.maven-plugin', '0.0.2') }}</version>
   <!-- Required to allow auto-install of Sentry SDK and Integrations -->
   <extensions>true</extensions>
+  <configuration>
+    <!-- In case you're self hosting, provide the URL here -->
+    <!-- <url>http://localhost:8000/</url> -->
+    <org>___SENTRY_ORG_SLUG___</org>
+    <project>___SENTRY_PROJECT_SLUG___</project>
+    <!-- Do not commit you auth token with this file, you should provide it via the SENTRY_AUTH_TOKEN environment variable or similar -->
+    <!-- <authToken>${env.SENTRY_AUTH_TOKEN}</authToken> -->
+    <authToken>___SENTRY_AUTH_TOKEN___</authToken>
+    <!-- Enable debugging to see logs in case something goes wrong when uploading the source bundle -->
+    <debugSentryCli>true</debugSentryCli>
+   </configuration>
+   <executions>
+    <execution>
+      <goals>
+        <!-- Generates a source bundle and uploads it to Sentry -->
+        <!-- This enables source context, allowing you to see your source code as part of your stack traces in Sentry -->
+        <!-- Learn more about this feature in its dedicated "Source Context" docs page -->
+        <goal>uploadSourceBundle</goal>
+      </goals>
+    </execution>
+  </executions>
 </plugin>
 ```
 
diff --git a/platform-includes/getting-started-install/java.spring.mdx b/platform-includes/getting-started-install/java.spring.mdx
index c3ecb692f5309..5cd472c738614 100644
--- a/platform-includes/getting-started-install/java.spring.mdx
+++ b/platform-includes/getting-started-install/java.spring.mdx
@@ -15,6 +15,27 @@ plugins {
   <version>{{@inject packages.version('sentry.java.maven-plugin', '0.0.2') }}</version>
   <!-- Required to allow auto-install of Sentry SDK and Integrations -->
   <extensions>true</extensions>
+  <configuration>
+    <!-- In case you're self hosting, provide the URL here -->
+    <!-- <url>http://localhost:8000/</url> -->
+    <org>___SENTRY_ORG_SLUG___</org>
+    <project>___SENTRY_PROJECT_SLUG___</project>
+    <!-- Do not commit you auth token with this file, you should provide it via the SENTRY_AUTH_TOKEN environment variable or similar -->
+    <!-- <authToken>${env.SENTRY_AUTH_TOKEN}</authToken> -->
+    <authToken>___SENTRY_AUTH_TOKEN___</authToken>
+    <!-- Enable debugging to see logs in case something goes wrong when uploading the source bundle -->
+    <debugSentryCli>true</debugSentryCli>
+   </configuration>
+   <executions>
+    <execution>
+      <goals>
+        <!-- Generates a source bundle and uploads it to Sentry -->
+        <!-- This enables source context, allowing you to see your source code as part of your stack traces in Sentry -->
+        <!-- Learn more about this feature in its dedicated "Source Context" docs page -->
+        <goal>uploadSourceBundle</goal>
+      </goals>
+    </execution>
+  </executions>
 </plugin>
 ```
 
@@ -26,6 +47,22 @@ implementation 'io.sentry:sentry-spring:{{@inject packages.version('sentry.java.
 implementation 'io.sentry:sentry-spring-jakarta:{{@inject packages.version('sentry.java.spring.jakarta', '6.7.0') }}'
 ```
 
+```xml {tabTitle:Maven (Spring 5)}
+<dependency>
+    <groupId>io.sentry</groupId>
+    <artifactId>sentry-spring</artifactId>
+    <version>{{@inject packages.version('sentry.java.spring', '4.2.0') }}</version>
+</dependency>
+```
+
+```xml {tabTitle:Maven (Spring 6)}
+<dependency>
+    <groupId>io.sentry</groupId>
+    <artifactId>sentry-spring-jakarta</artifactId>
+    <version>{{@inject packages.version('sentry.java.spring.jakarta', '6.7.0') }}</version>
+</dependency>
+```
+
 ```scala {tabTitle: SBT (Spring 5)}
 libraryDependencies += "io.sentry" % "sentry-spring" % "{{@inject packages.version('sentry.java.spring', '4.2.0') }}"
 ```

From 2d1742b8fe44c4f6db77b7df6ff965e1d1f27ea1 Mon Sep 17 00:00:00 2001
From: lcian <lorenzo.cian@sentry.io>
Date: Thu, 20 Feb 2025 16:53:08 +0100
Subject: [PATCH 3/4] add back raw Maven deps for Spring boot as well

---
 .../getting-started-install/java.spring-boot.mdx  | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/platform-includes/getting-started-install/java.spring-boot.mdx b/platform-includes/getting-started-install/java.spring-boot.mdx
index 397d3c1094e08..0e9b4b6250ae9 100644
--- a/platform-includes/getting-started-install/java.spring-boot.mdx
+++ b/platform-includes/getting-started-install/java.spring-boot.mdx
@@ -47,6 +47,21 @@ implementation 'io.sentry:sentry-spring-boot-starter:{{@inject packages.version(
 implementation 'io.sentry:sentry-spring-boot-starter-jakarta:{{@inject packages.version('sentry.java.spring-boot.jakarta', '6.7.0') }}'
 ```
 
+```xml {tabTitle:Maven (Spring Boot 2)}
+<dependency>
+    <groupId>io.sentry</groupId>
+    <artifactId>sentry-spring-boot-starter</artifactId>
+    <version>{{@inject packages.version('sentry.java.spring-boot', '4.2.0') }}</version>
+</dependency>
+```
+
+```xml {tabTitle:Maven (Spring Boot 3)}
+<dependency>
+    <groupId>io.sentry</groupId>
+    <artifactId>sentry-spring-boot-starter-jakarta</artifactId>
+    <version>{{@inject packages.version('sentry.java.spring-boot.jakarta', '6.7.0') }}</version>
+</dependency>
+
 <Alert>
 
 We recommend using our Gradle plugin as it can add integrations and provide source context for events.

From 6a6e1f46ef29370dfefc28f20f62723c23039385 Mon Sep 17 00:00:00 2001
From: lcian <lorenzo.cian@sentry.io>
Date: Tue, 25 Feb 2025 12:51:00 +0100
Subject: [PATCH 4/4] trigger Vercel