Update recipe documentation examples (#157)

Use this link to re-run the recipe: https://app.moderne.io/recipes/org.openrewrite.recipes.rewrite.OpenRewriteRecipeBestPractices?organizationId=ODQ2MGExMTUtNDg0My00N2EwLTgzMGMtNGE1NGExMTBmZDkw

Co-authored-by: Moderne <[email protected]>

Author: timtebeek

src/main/resources/META-INF/rewrite/examples.yml

@@ -56,7 +56,7 @@ examples:
 type: specs.openrewrite.org/v1beta/example
 recipeName: org.openrewrite.java.dependencies.DependencyInsight
 examples:
-- description: ''
+- description: '`DependencyInsightTest#maven`'
   parameters:
   - org.springframework*
   - '*'
@@ -97,7 +97,7 @@ examples:
 type: specs.openrewrite.org/v1beta/example
 recipeName: org.openrewrite.java.dependencies.DependencyResolutionDiagnostic
 examples:
-- description: ''
+- description: '`DependencyResolutionDiagnosticTest#gradleNoMarker`'
   parameters:
   - 'null'
   - 'null'
@@ -117,7 +117,7 @@ examples:
 type: specs.openrewrite.org/v1beta/example
 recipeName: org.openrewrite.java.dependencies.FindDependency
 examples:
-- description: ''
+- description: '`FindDependencyTest#findMavenDependency`'
   parameters:
   - org.openrewrite
   - rewrite-core
@@ -157,7 +157,7 @@ examples:
 type: specs.openrewrite.org/v1beta/example
 recipeName: org.openrewrite.java.dependencies.RelocatedDependencyCheck
 examples:
-- description: ''
+- description: '`Maven#findRelocatedMavenDependencies`'
   parameters:
   - 'null'
   sources:
@@ -287,7 +287,7 @@ examples:
 type: specs.openrewrite.org/v1beta/example
 recipeName: org.openrewrite.java.dependencies.search.DoesNotIncludeDependency
 examples:
-- description: ''
+- description: '`DoesNotIncludeDependencyTest#whenDoesNotIncludeDependencyInCorrectScopeOrConfigurationMarks`'
   parameters:
   - org.springframework
   - spring-beans
@@ -351,7 +351,7 @@ examples:
 type: specs.openrewrite.org/v1beta/example
 recipeName: org.openrewrite.java.dependencies.search.FindMinimumDependencyVersion
 examples:
-- description: ''
+- description: '`FindMinimumDependencyVersionTest#minimumMaven`'
   parameters:
   - com.fasterxml.jackson*
   - jackson-core

src/test/java/org/openrewrite/java/dependencies/AddDependencyTest.java

@@ -20,6 +20,7 @@
 import org.junit.jupiter.api.Test;
 import org.junit.jupiter.params.ParameterizedTest;
 import org.junit.jupiter.params.provider.ValueSource;
+import org.openrewrite.DocumentExample;
 import org.openrewrite.java.JavaParser;
 import org.openrewrite.test.RecipeSpec;
 import org.openrewrite.test.RewriteTest;
@@ -46,44 +47,7 @@ boolean getMap() {
           }
       """;
 
-    @ParameterizedTest
-    @ValueSource(strings = {"com.google.common.math.*", "com.google.common.math.IntMath"})
-    void addGradleDependencyWithOnlyIfUsingTestScope(String onlyIfUsing) {
-        rewriteRun(
-          spec -> spec.beforeRecipe(withToolingApi()).recipe(addDependency("com.google.guava:guava:29.0-jre", onlyIfUsing, null)),
-          mavenProject("project",
-            srcTestJava(
-              java(usingGuavaIntMath)
-            ),
-            //language=groovy
-            buildGradle(
-              """
-                plugins {
-                    id "java-library"
-                }
-                
-                repositories {
-                    mavenCentral()
-                }
-                """,
-              """
-                plugins {
-                    id "java-library"
-                }
-                
-                repositories {
-                    mavenCentral()
-                }
-                
-                dependencies {
-                    testImplementation "com.google.guava:guava:29.0-jre"
-                }
-                """
-            )
-          )
-        );
-    }
-
+    @DocumentExample
     @Test
     void addMavenDependencyWithSystemScope() {
         rewriteRun(
@@ -122,6 +86,44 @@ void addMavenDependencyWithSystemScope() {
         );
     }
 
+    @ParameterizedTest
+    @ValueSource(strings = {"com.google.common.math.*", "com.google.common.math.IntMath"})
+    void addGradleDependencyWithOnlyIfUsingTestScope(String onlyIfUsing) {
+        rewriteRun(
+          spec -> spec.beforeRecipe(withToolingApi()).recipe(addDependency("com.google.guava:guava:29.0-jre", onlyIfUsing, null)),
+          mavenProject("project",
+            srcTestJava(
+              java(usingGuavaIntMath)
+            ),
+            //language=groovy
+            buildGradle(
+              """
+                plugins {
+                    id "java-library"
+                }
+                
+                repositories {
+                    mavenCentral()
+                }
+                """,
+              """
+                plugins {
+                    id "java-library"
+                }
+                
+                repositories {
+                    mavenCentral()
+                }
+                
+                dependencies {
+                    testImplementation "com.google.guava:guava:29.0-jre"
+                }
+                """
+            )
+          )
+        );
+    }
+
 
     private AddDependency addDependency(String gav, String onlyIfUsing, @Nullable String scope) {
         String[] gavParts = gav.split(":");