openrewrite · timtebeek · Oct 4, 2025 · Oct 4, 2025
diff --git a/src/main/resources/META-INF/rewrite/examples.yml b/src/main/resources/META-INF/rewrite/examples.yml
diff --git a/src/test/java/org/openrewrite/java/migrate/DontOverfetchDtoTest.java b/src/test/java/org/openrewrite/java/migrate/DontOverfetchDtoTest.java
@@ -16,13 +16,15 @@
 package org.openrewrite.java.migrate;
 
 import org.junit.jupiter.api.Test;
+import org.openrewrite.DocumentExample;
 import org.openrewrite.test.RewriteTest;
 import org.openrewrite.test.TypeValidation;
 
 import static org.openrewrite.java.Assertions.java;
 
 class DontOverfetchDtoTest implements RewriteTest {
 
+    @DocumentExample
     @SuppressWarnings("LombokGetterMayBeUsed")
     @Test
     void findDtoOverfetching() {

diff --git a/src/test/java/org/openrewrite/java/migrate/guava/NoGuavaImmutableListOfTest.java b/src/test/java/org/openrewrite/java/migrate/guava/NoGuavaImmutableListOfTest.java
@@ -16,6 +16,7 @@
 package org.openrewrite.java.migrate.guava;
 
 import org.junit.jupiter.api.Test;
+import org.openrewrite.DocumentExample;
 import org.openrewrite.InMemoryExecutionContext;
 import org.openrewrite.Issue;
 import org.openrewrite.java.JavaParser;
@@ -33,6 +34,34 @@ public void defaults(RecipeSpec spec) {
           .parser(JavaParser.fromJavaVersion().classpathFromResources(new InMemoryExecutionContext(), "guava"));
     }
 
+    @DocumentExample
+    @Test
+    void replaceArguments() {
+        rewriteRun(
+          version(
+            //language=java
+            java(
+              """
+                import java.util.List;
+                import com.google.common.collect.ImmutableList;
+
+                class Test {
+                    List<String> m = ImmutableList.of("A", "B", "C", "D");
+                }
+                """,
+              """
+                import java.util.List;
+
+                class Test {
+                    List<String> m = List.of("A", "B", "C", "D");
+                }
+                """
+            ),
+            9
+          )
+        );
+    }
+
     @Test
     void doNotChangeReturnsImmutableList() {
         rewriteRun(
@@ -166,33 +195,6 @@ void method() {
         );
     }
 
-    @Test
-    void replaceArguments() {
-        rewriteRun(
-          version(
-            //language=java
-            java(
-              """
-                import java.util.List;
-                import com.google.common.collect.ImmutableList;
-
-                class Test {
-                    List<String> m = ImmutableList.of("A", "B", "C", "D");
-                }
-                """,
-              """
-                import java.util.List;
-
-                class Test {
-                    List<String> m = List.of("A", "B", "C", "D");
-                }
-                """
-            ),
-            9
-          )
-        );
-    }
-
     @Test
     void fieldAssignmentToList() {
         rewriteRun(

diff --git a/src/test/java/org/openrewrite/java/migrate/guava/NoGuavaImmutableMapOfTest.java b/src/test/java/org/openrewrite/java/migrate/guava/NoGuavaImmutableMapOfTest.java
@@ -17,6 +17,7 @@
 
 import org.junit.jupiter.api.Nested;
 import org.junit.jupiter.api.Test;
+import org.openrewrite.DocumentExample;
 import org.openrewrite.InMemoryExecutionContext;
 import org.openrewrite.Issue;
 import org.openrewrite.java.JavaParser;
@@ -34,6 +35,34 @@ public void defaults(RecipeSpec spec) {
           .parser(JavaParser.fromJavaVersion().classpathFromResources(new InMemoryExecutionContext(), "guava"));
     }
 
+    @DocumentExample
+    @Test
+    void replaceArguments() {
+        //language=java
+        rewriteRun(
+          version(
+            java(
+              """
+                import java.util.Map;
+                import com.google.common.collect.ImmutableMap;
+
+                class Test {
+                    Map<String, String> m = ImmutableMap.of("A", "B", "C", "D");
+                }
+                """,
+              """
+                import java.util.Map;
+
+                class Test {
+                    Map<String, String> m = Map.of("A", "B", "C", "D");
+                }
+                """
+            ),
+            9
+          )
+        );
+    }
+
     @Test
     void doNotChangeReturnsImmutableMap() {
         //language=java
@@ -151,33 +180,6 @@ void method() {
         );
     }
 
-    @Test
-    void replaceArguments() {
-        //language=java
-        rewriteRun(
-          version(
-            java(
-              """
-                import java.util.Map;
-                import com.google.common.collect.ImmutableMap;
-
-                class Test {
-                    Map<String, String> m = ImmutableMap.of("A", "B", "C", "D");
-                }
-                """,
-              """
-                import java.util.Map;
-
-                class Test {
-                    Map<String, String> m = Map.of("A", "B", "C", "D");
-                }
-                """
-            ),
-            9
-          )
-        );
-    }
-
     @Test
     void fieldAssignmentToMap() {
         //language=java

diff --git a/src/test/java/org/openrewrite/java/migrate/guava/NoGuavaJava21Test.java b/src/test/java/org/openrewrite/java/migrate/guava/NoGuavaJava21Test.java
@@ -16,6 +16,7 @@
 package org.openrewrite.java.migrate.guava;
 
 import org.junit.jupiter.api.Test;
+import org.openrewrite.DocumentExample;
 import org.openrewrite.InMemoryExecutionContext;
 import org.openrewrite.Issue;
 import org.openrewrite.java.JavaParser;
@@ -32,6 +33,7 @@ public void defaults(RecipeSpec spec) {
           .parser(JavaParser.fromJavaVersion().classpathFromResources(new InMemoryExecutionContext(), "guava"));
     }
 
+    @DocumentExample
     @Test
     void preferMathClampForDouble() {
         //language=java

diff --git a/src/test/java/org/openrewrite/java/migrate/jakarta/JavaxMailToJakartaMailTest.java b/src/test/java/org/openrewrite/java/migrate/jakarta/JavaxMailToJakartaMailTest.java
@@ -16,6 +16,7 @@
 package org.openrewrite.java.migrate.jakarta;
 
 import org.junit.jupiter.api.Test;
+import org.openrewrite.DocumentExample;
 import org.openrewrite.java.JavaParser;
 import org.openrewrite.test.RecipeSpec;
 import org.openrewrite.test.RewriteTest;
@@ -34,6 +35,7 @@ public void defaults(RecipeSpec spec) {
             "org.openrewrite.java.migrate.jakarta.JavaxMailToJakartaMail");
     }
 
+    @DocumentExample
     @Test
     void switchesJavaxMailApiDependencyToJakartaMailApiDependency() {
         rewriteRun(

diff --git a/src/test/java/org/openrewrite/java/migrate/jakarta/JavaxServletToJakartaServletTest.java b/src/test/java/org/openrewrite/java/migrate/jakarta/JavaxServletToJakartaServletTest.java
@@ -16,6 +16,7 @@
 package org.openrewrite.java.migrate.jakarta;
 
 import org.junit.jupiter.api.Test;
+import org.openrewrite.DocumentExample;
 import org.openrewrite.InMemoryExecutionContext;
 import org.openrewrite.java.JavaParser;
 import org.openrewrite.test.RecipeSpec;
@@ -35,6 +36,7 @@ public void defaults(RecipeSpec spec) {
             "org.openrewrite.java.migrate.jakarta.JavaxServletToJakartaServlet");
     }
 
+    @DocumentExample
     @Test
     void switchesJavaxServletApiDependencyToJakartaServletApiDependency() {
         rewriteRun(

diff --git a/src/test/java/org/openrewrite/java/migrate/jakarta/JavaxWsToJakartaWsTest.java b/src/test/java/org/openrewrite/java/migrate/jakarta/JavaxWsToJakartaWsTest.java
@@ -16,6 +16,7 @@
 package org.openrewrite.java.migrate.jakarta;
 
 import org.junit.jupiter.api.Test;
+import org.openrewrite.DocumentExample;
 import org.openrewrite.java.JavaParser;
 import org.openrewrite.test.RecipeSpec;
 import org.openrewrite.test.RewriteTest;
@@ -33,6 +34,7 @@ public void defaults(RecipeSpec spec) {
             "org.openrewrite.java.migrate.jakarta.JavaxWsToJakartaWs");
     }
 
+    @DocumentExample
     @Test
     void switchesJavaxWsApiDependencyToJakartaWsApiDependency() {
         rewriteRun(

diff --git a/src/test/java/org/openrewrite/java/migrate/javax/AddCommonAnnotationsDependenciesTest.java b/src/test/java/org/openrewrite/java/migrate/javax/AddCommonAnnotationsDependenciesTest.java
@@ -16,6 +16,7 @@
 package org.openrewrite.java.migrate.javax;
 
 import org.junit.jupiter.api.Test;
+import org.openrewrite.DocumentExample;
 import org.openrewrite.java.JavaParser;
 import org.openrewrite.test.RecipeSpec;
 import org.openrewrite.test.RewriteTest;
@@ -33,6 +34,7 @@ public void defaults(RecipeSpec spec) {
           .allSources(src -> src.markers(javaVersion(8)));
     }
 
+    @DocumentExample
     @Test
     void addDependencyIfAnnotationJsr250Present() {
         rewriteRun(

diff --git a/src/test/java/org/openrewrite/java/migrate/lang/StringFormattedTest.java b/src/test/java/org/openrewrite/java/migrate/lang/StringFormattedTest.java
@@ -16,6 +16,7 @@
 package org.openrewrite.java.migrate.lang;
 
 import org.junit.jupiter.api.Test;
+import org.openrewrite.DocumentExample;
 import org.openrewrite.Issue;
 import org.openrewrite.test.RecipeSpec;
 import org.openrewrite.test.RewriteTest;
@@ -30,29 +31,25 @@ public void defaults(RecipeSpec spec) {
         spec.recipe(new StringFormatted(null));
     }
 
-    @Issue("https://github.com/openrewrite/rewrite/issues/2163")
+    @DocumentExample
     @Test
-    void textBlock() {
+    void concatenatedText() {
         //language=java
         rewriteRun(
           version(
             java(
               """
                 package com.example.app;
                 class A {
-                    String str = String.format(\"""
-                    foo
-                    %s
-                    \""", "a");
+                    String str = String.format("foo"
+                            + "%s", "a");
                 }
                 """,
               """
                 package com.example.app;
                 class A {
-                    String str = \"""
-                    foo
-                    %s
-                    \""".formatted("a");
+                    String str = ("foo"
+                            + "%s").formatted("a");
                 }
                 """
             ),
@@ -61,24 +58,29 @@ class A {
         );
     }
 
+    @Issue("https://github.com/openrewrite/rewrite/issues/2163")
     @Test
-    void concatenatedText() {
+    void textBlock() {
         //language=java
         rewriteRun(
           version(
             java(
               """
                 package com.example.app;
                 class A {
-                    String str = String.format("foo"
-                            + "%s", "a");
+                    String str = String.format(\"""
+                    foo
+                    %s
+                    \""", "a");
                 }
                 """,
               """
                 package com.example.app;
                 class A {
-                    String str = ("foo"
-                            + "%s").formatted("a");
+                    String str = \"""
+                    foo
+                    %s
+                    \""".formatted("a");
                 }
                 """
             ),

diff --git a/src/test/java/org/openrewrite/java/migrate/lombok/UpdateLombokToJava11Test.java b/src/test/java/org/openrewrite/java/migrate/lombok/UpdateLombokToJava11Test.java
@@ -16,6 +16,7 @@
 package org.openrewrite.java.migrate.lombok;
 
 import org.junit.jupiter.api.Test;
+import org.openrewrite.DocumentExample;
 import org.openrewrite.config.Environment;
 import org.openrewrite.java.JavaParser;
 import org.openrewrite.test.RecipeSpec;
@@ -69,6 +70,7 @@ public void defaults(RecipeSpec spec) {
           );
     }
 
+    @DocumentExample
     @SuppressWarnings({"DeprecatedLombok", "deprecation", "Lombok", "RedundantModifiersValueLombok"})
     @Test
     void updateLombokToJava11() {

diff --git a/src/test/java/org/openrewrite/java/migrate/search/FindInternalJavaxApisTest.java b/src/test/java/org/openrewrite/java/migrate/search/FindInternalJavaxApisTest.java
@@ -16,6 +16,7 @@
 package org.openrewrite.java.migrate.search;
 
 import org.junit.jupiter.api.Test;
+import org.openrewrite.DocumentExample;
 import org.openrewrite.test.RecipeSpec;
 import org.openrewrite.test.RewriteTest;
 
@@ -28,6 +29,7 @@ public void defaults(RecipeSpec spec) {
         spec.recipe(new FindInternalJavaxApis(null));
     }
 
+    @DocumentExample
     @Test
     void returnsJavaxApi() {
         //language=java

diff --git a/src/test/java/org/openrewrite/java/migrate/util/OptionalNotEmptyToIsPresentTest.java b/src/test/java/org/openrewrite/java/migrate/util/OptionalNotEmptyToIsPresentTest.java
@@ -16,6 +16,7 @@
 package org.openrewrite.java.migrate.util;
 
 import org.junit.jupiter.api.Test;
+import org.openrewrite.DocumentExample;
 import org.openrewrite.java.JavaParser;
 import org.openrewrite.test.RecipeSpec;
 import org.openrewrite.test.RewriteTest;
@@ -33,6 +34,7 @@ public void defaults(RecipeSpec spec) {
           .parser(JavaParser.fromJavaVersion());
     }
 
+    @DocumentExample
     @Test
     void replaceNotIsEmptyWithIsPresent() {
         //language=java

diff --git a/src/test/java/org/openrewrite/java/migrate/util/OptionalNotPresentToIsEmptyTest.java b/src/test/java/org/openrewrite/java/migrate/util/OptionalNotPresentToIsEmptyTest.java
@@ -16,6 +16,7 @@
 package org.openrewrite.java.migrate.util;
 
 import org.junit.jupiter.api.Test;
+import org.openrewrite.DocumentExample;
 import org.openrewrite.java.JavaParser;
 import org.openrewrite.test.RecipeSpec;
 import org.openrewrite.test.RewriteTest;
@@ -33,6 +34,7 @@ public void defaults(RecipeSpec spec) {
           .parser(JavaParser.fromJavaVersion());
     }
 
+    @DocumentExample
     @Test
     void replaceNotIsPresentWithIsEmpty() {
         //language=java