add a reference to JavaTemplates documentation on first usage in `N…

…oGuavaListsNewArrayList` (#69)

* add a reference to `JavaTemplate`s documentation on first usage in `NoGuavaListsNewArrayList`

* migrate to new rewrite-rewrite for best practices

pom.xml

@@ -222,8 +222,8 @@
                     </dependency>
                     <dependency>
                         <groupId>org.openrewrite.recipe</groupId>
-                        <artifactId>rewrite-recommendations</artifactId>
-                        <version>1.14.1</version>
+                        <artifactId>rewrite-rewrite</artifactId>
+                        <version>0.1.0</version>
                     </dependency>
                 </dependencies>
             </plugin>

rewrite.yml

@@ -4,4 +4,4 @@ name: com.yourorg.ApplyRecipeBestPractices
 displayName: Apply Recipe best practices
 description: Apply best practices to your recipes, through OpenRewrite's best practices recipe & IntelliJ IDEA plugin.
 recipeList:
-  - org.openrewrite.recipes.OpenRewriteBestPractices
+  - org.openrewrite.recipes.rewrite.OpenRewriteRecipeBestPractices

src/main/java/com/yourorg/NoGuavaListsNewArrayList.java

@@ -61,6 +61,9 @@ public TreeVisitor<?, ExecutionContext> getVisitor() {
                 // To avoid stale state persisting between cycles, getVisitor() should always return a new instance of
                 // its visitor
                 new JavaVisitor<ExecutionContext>() {
+                    // Java Templates are used to generate Java code easily.
+                    // They use a syntax that expand Java with possible type-safe insertions points.
+                    // See https://docs.openrewrite.org/concepts-and-explanations/javatemplate for full documentation
                     private final JavaTemplate newArrayList = JavaTemplate.builder("new ArrayList<>()")
                             .imports("java.util.ArrayList")
                             .build();
@@ -84,6 +87,7 @@ public J visitCompilationUnit(J.CompilationUnit cu, ExecutionContext ctx) {
                         System.out.printf(printed);
 
                         // You must always delegate to the super method to ensure the visitor continues to visit deeper
+                        // return cu; // this leads to a recipe that makes no changes at all
                         return super.visitCompilationUnit(cu, ctx);
                     }