From 8fb1dc002805cda7bc36bfa93ae4fddf3238badb Mon Sep 17 00:00:00 2001
From: Mike Solomon <mike-solomon@users.noreply.github.com>
Date: Wed, 25 Sep 2024 09:11:27 -0700
Subject: [PATCH 01/17] Replace {% stuff with Docusaurus stuff

---
 .../openrewrite/RecipeMarkdownGenerator.kt    | 642 ++++++++----------
 1 file changed, 300 insertions(+), 342 deletions(-)

diff --git a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
index 9034fff..3706571 100644
--- a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
+++ b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
@@ -490,15 +490,15 @@ class RecipeMarkdownGenerator : Runnable {
         if (deployType == "snapshot") {
             changelog.appendText("# Snapshot ($formatted)")
 
-            changelog.appendText("\n\n{% hint style=\"info\" %}")
+            changelog.appendText("\n\n:::info")
             changelog.appendText("\nWant to learn how to use snapshot versions in your project? Check out our [snapshot version guide](/reference/snapshot-instructions.md).")
-            changelog.appendText("\n{% endhint %}\n\n")
+            changelog.appendText("\n:::\n\n")
         } else {
             changelog.appendText("# $rewriteBomVersion release ($formatted)")
 
-            changelog.appendText("\n\n{% hint style=\"info\" %}")
+            changelog.appendText("\n\n:::info")
             changelog.appendText("\nThis changelog only shows what recipes have been added, removed, or changed. OpenRewrite may do releases that do not include these types of changes. To see these changes, please go to the [releases page](https://github.com/openrewrite/rewrite/releases).")
-            changelog.appendText("\n{% endhint %}\n\n")
+            changelog.appendText("\n:::\n\n")
         }
 
         // An example of what the changelog could look like after the below statements can be found here:
@@ -936,9 +936,9 @@ class RecipeMarkdownGenerator : Runnable {
         if (recipeDescriptor.recipeList.size > 1) {
             writeln(
                 """
-                    {% hint style="info" %}
+                    :::info
                     This recipe is composed of more than one recipe. If you want to customize the set of recipes this is composed of, you can find and copy the GitHub source for the recipe from the link above.
-                    {% endhint %}
+                    :::
                     """.trimIndent()
             )
         }
@@ -1092,8 +1092,8 @@ class RecipeMarkdownGenerator : Runnable {
                     if (hasChange && source.before != null) {
                         newLine()
                         val tabName = source.path ?: (source.language ?: "Before / After")
-                        writeln("{% tabs %}")
-                        writeln("{% tab title=\"${tabName}\" %}")
+                        writeln("<Tabs>")
+                        writeln("  <TabItem value=\"${tabName}\" title=\"${tabName}\">")
                     }
 
                     newLine()
@@ -1102,19 +1102,16 @@ class RecipeMarkdownGenerator : Runnable {
                         writeln("###### $beforeTitle")
 
                         if (source.path != null) {
-                            writeln("{% code title=\"${source.path}\" %}")
+                            writeln("```${source.language} title=\"${source.path}\"")
                         } else {
-                            writeln("{% code %}")
+                            writeln("```${source.language}")
                         }
 
-                        writeln("```${source.language}")
                         write(source.before)
                         if (source.before != null && !source.before.endsWith("\n")) {
                             newLine()
                         }
                         writeln("```")
-
-                        writeln("{% endcode %}")
                     }
 
                     if (hasChange) {
@@ -1122,38 +1119,34 @@ class RecipeMarkdownGenerator : Runnable {
                         writeln("###### $afterTile")
 
                         if (source.path != null) {
-                            writeln("{% code title=\"${source.path}\" %}")
+                            writeln("```${source.language} title=\"${source.path}\"")
                         } else {
-                            writeln("{% code %}")
+                            writeln("```${source.language}")
                         }
 
-                        writeln("```${source.language}")
                         write(source.after)
                         if (source.after != null && !source.after.endsWith("\n")) {
                             newLine()
                         }
                         writeln("```")
 
-                        writeln("{% endcode %}")
                         newLine()
 
                         // diff
                         if (source.before != null) {
-                            writeln("{% endtab %}")
-                            writeln("{% tab title=\"Diff\" %}")
+                            writeln("  </TabItem>")
+                            writeln("<TabItem title=\"Diff\" >")
 
                             val diff = generateDiff(source.path, source.before, source.after)
 
-                            writeln("{% code %}")
                             writeln(
                                 """
                                     |```diff
                                     |${diff}```
                                     """.trimMargin()
                             )
-                            writeln("{% endcode %}")
-                            writeln("{% endtab %}")
-                            writeln("{% endtabs %}")
+                            writeln("  </TabItem>")
+                            writeln("</Tabs>")
                         }
                     }
                 }
@@ -1197,9 +1190,7 @@ class RecipeMarkdownGenerator : Runnable {
             writeln("Here's how you can define and customize such a recipe within your rewrite.yml:")
             write(
                 """
-                        
-                        {% code title="rewrite.yml" %}
-                        ```yaml
+                        ```yaml title="rewrite.yml"
                         ---
                         type: specs.openrewrite.org/v1beta/recipe
                         name: $exampleRecipeName
@@ -1226,7 +1217,6 @@ class RecipeMarkdownGenerator : Runnable {
                 writeln("      ${option.name}: $ex")
             }
             writeln("```")
-            writeln("{% endcode %}")
             newLine()
 
             if (requiresDependency) {
@@ -1286,8 +1276,8 @@ class RecipeMarkdownGenerator : Runnable {
                         
                         ## Definition
                         
-                        {% tabs %}
-                        {% tab title="Recipe List" %}
+                        <Tab>
+                          <TabItem title="Recipe List" >
                     """.trimIndent()
             )
             val recipeDepth = getRecipePath(recipeDescriptor).chars().filter { ch: Int -> ch == '/'.code }.count()
@@ -1314,9 +1304,9 @@ class RecipeMarkdownGenerator : Runnable {
             newLine()
             writeln(
                 """
-                        {% endtab %}
+                          </TabItem>
     
-                        {% tab title="Yaml Recipe List" %}
+                          <TabItem title="Yaml Recipe List">
                         ```yaml
                     """.trimIndent()
             )
@@ -1324,8 +1314,8 @@ class RecipeMarkdownGenerator : Runnable {
             writeln(
                 """
                         ```
-                        {% endtab %}
-                        {% endtabs %}
+                          </TabItem>
+                        </Tabs>
                     """.trimIndent()
             )
         }
@@ -1420,15 +1410,13 @@ class RecipeMarkdownGenerator : Runnable {
         }
 
         return """
-                {% tab title="Moderne CLI" %}
-                You will need to have configured the [Moderne CLI](https://docs.moderne.io/moderne-cli/cli-intro) on your machine before you can run the following command.
-
-                {% code title="shell" %}
-                ```shell
-                mod run . --recipe $trimmedRecipeName
-                ```
-                {% endcode %}
-                {% endtab %}
+                <TabItem title="Moderne CLI">
+                    You will need to have configured the [Moderne CLI](https://docs.moderne.io/moderne-cli/cli-intro) on your machine before you can run the following command.
+    
+                    ```shell title="shell"
+                    mod run . --recipe $trimmedRecipeName
+                    ```
+                </TabItem>
         """.trimIndent()
     }
 
@@ -1442,64 +1430,60 @@ class RecipeMarkdownGenerator : Runnable {
         dataTableSnippet: String,
     ) {
         val gradleSnippet = if (suppressGradle) "" else """
-                            {% tab title="Gradle" %}
-                            1. Add the following to your `build.gradle` file:
-                            {% code title="build.gradle" %}
-                            ```groovy
-                            plugins {
-                                id("org.openrewrite.rewrite") version("$gradlePluginVersion")
-                            }
-                            
-                            rewrite {
-                                activeRecipe("$exampleRecipeName")
-                                exportDatatables = true
-                            }
-                            
-                            repositories {
-                                mavenCentral()
-                            }
-                            ```
-                            {% endcode %}
-                            2. Run `gradle rewriteRun` to run the recipe.
-                            {% endtab %}
+                            <TabItem title="Gradle">
+                                1. Add the following to your `build.gradle` file:
+                                ```groovy title="build.gradle"
+                                plugins {
+                                    id("org.openrewrite.rewrite") version("$gradlePluginVersion")
+                                }
+                                
+                                rewrite {
+                                    activeRecipe("$exampleRecipeName")
+                                    exportDatatables = true
+                                }
+                                
+                                repositories {
+                                    mavenCentral()
+                                }
+                                ```
+                                2. Run `gradle rewriteRun` to run the recipe.
+                            </TabItem>
                             """.trimIndent()
 
         val mavenSnippet = if (suppressMaven) "" else """
-                            {% tab title="Maven" %}
-                            1. Add the following to your `pom.xml` file:
-                            {% code title="pom.xml" %}
-                            ```xml
-                            <project>
-                              <build>
-                                <plugins>
-                                  <plugin>
-                                    <groupId>org.openrewrite.maven</groupId>
-                                    <artifactId>rewrite-maven-plugin</artifactId>
-                                    <version>$mavenPluginVersion</version>
-                                    <configuration>
-                                      $dataTableSnippet
-                                      <activeRecipes>
-                                        <recipe>$exampleRecipeName</recipe>
-                                      </activeRecipes>
-                                    </configuration>
-                                  </plugin>
-                                </plugins>
-                              </build>
-                            </project>
-                            ```
-                            {% endcode %}
-                            2. Run `mvn rewrite:run` to run the recipe.
-                            {% endtab %}
+                            <TabItem title="Maven">
+                                1. Add the following to your `pom.xml` file:
+                                ```xml title="pom.xml"
+                                <project>
+                                  <build>
+                                    <plugins>
+                                      <plugin>
+                                        <groupId>org.openrewrite.maven</groupId>
+                                        <artifactId>rewrite-maven-plugin</artifactId>
+                                        <version>$mavenPluginVersion</version>
+                                        <configuration>
+                                          $dataTableSnippet
+                                          <activeRecipes>
+                                            <recipe>$exampleRecipeName</recipe>
+                                          </activeRecipes>
+                                        </configuration>
+                                      </plugin>
+                                    </plugins>
+                                  </build>
+                                </project>
+                                ```
+                                2. Run `mvn rewrite:run` to run the recipe.
+                            </TabItem>
                             """.trimIndent()
 
         writeln(
             """
 Now that `$exampleRecipeName` has been defined, activate it in your build file:
-{% tabs %}
-$gradleSnippet
-$mavenSnippet
-$cliSnippet
-{% endtabs %}
+<Tabs>
+  $gradleSnippet
+  $mavenSnippet
+  $cliSnippet
+</Tabs>
 """.trimIndent()
         )
     }
@@ -1515,75 +1499,71 @@ $cliSnippet
         dataTableSnippet: String,
     ) {
         val gradleSnippet = if (suppressGradle) "" else """
-                            {% tab title="Gradle" %}
-                            1. Add the following to your `build.gradle` file:
-                            {% code title="build.gradle" %}
-                            ```groovy
-                            plugins {
-                                id("org.openrewrite.rewrite") version("$gradlePluginVersion")
-                            }
-                            
-                            rewrite {
-                                activeRecipe("$exampleRecipeName")
-                                exportDatatables = true
-                            }
-                            
-                            repositories {
-                                mavenCentral()
-                            }
-                            
-                            dependencies {
-                                rewrite("${origin.groupId}:${origin.artifactId}:${origin.version}")
-                            }
-                            ```
-                            {% endcode %}
-                            2. Run `gradle rewriteRun` to run the recipe.
-                            {% endtab %}
+                            <TabItem title="Gradle">
+                                1. Add the following to your `build.gradle` file:
+                                ```groovy title="build.gradle"
+                                plugins {
+                                    id("org.openrewrite.rewrite") version("$gradlePluginVersion")
+                                }
+                                
+                                rewrite {
+                                    activeRecipe("$exampleRecipeName")
+                                    exportDatatables = true
+                                }
+                                
+                                repositories {
+                                    mavenCentral()
+                                }
+                                
+                                dependencies {
+                                    rewrite("${origin.groupId}:${origin.artifactId}:${origin.version}")
+                                }
+                                ```
+                                2. Run `gradle rewriteRun` to run the recipe.
+                            </TabItem>
                             """.trimIndent()
 
         val mavenSnippet = if (suppressMaven) "" else """
-                            {% tab title="Maven" %}
-                            1. Add the following to your `pom.xml` file:
-                            {% code title="pom.xml" %}
-                            ```xml
-                            <project>
-                              <build>
-                                <plugins>
-                                  <plugin>
-                                    <groupId>org.openrewrite.maven</groupId>
-                                    <artifactId>rewrite-maven-plugin</artifactId>
-                                    <version>$mavenPluginVersion</version>
-                                    <configuration>
-                                      $dataTableSnippet
-                                      <activeRecipes>
-                                        <recipe>$exampleRecipeName</recipe>
-                                      </activeRecipes>
-                                    </configuration>
-                                    <dependencies>
-                                      <dependency>
-                                        <groupId>${origin.groupId}</groupId>
-                                        <artifactId>${origin.artifactId}</artifactId>
-                                        <version>${origin.version}</version>
-                                      </dependency>
-                                    </dependencies>
-                                  </plugin>
-                                </plugins>
-                              </build>
-                            </project>
-                            ```
-                            {% endcode %}
-                            2. Run `mvn rewrite:run` to run the recipe.
-                            {% endtab %}
+                            <TabItem title="Maven">
+                                1. Add the following to your `pom.xml` file:
+                                ```xml title="pom.xml"
+                                <project>
+                                  <build>
+                                    <plugins>
+                                      <plugin>
+                                        <groupId>org.openrewrite.maven</groupId>
+                                        <artifactId>rewrite-maven-plugin</artifactId>
+                                        <version>$mavenPluginVersion</version>
+                                        <configuration>
+                                          $dataTableSnippet
+                                          <activeRecipes>
+                                            <recipe>$exampleRecipeName</recipe>
+                                          </activeRecipes>
+                                        </configuration>
+                                        <dependencies>
+                                          <dependency>
+                                            <groupId>${origin.groupId}</groupId>
+                                            <artifactId>${origin.artifactId}</artifactId>
+                                            <version>${origin.version}</version>
+                                          </dependency>
+                                        </dependencies>
+                                      </plugin>
+                                    </plugins>
+                                  </build>
+                                </project>
+                                ```
+                                2. Run `mvn rewrite:run` to run the recipe.
+                            </TabItem>
                             """.trimIndent()
 
         writeln(
             """
 Now that `$exampleRecipeName` has been defined, activate it and take a dependency on ${origin.groupId}:${origin.artifactId}:${origin.version} in your build file:
-{% tabs %}
-$gradleSnippet
-$mavenSnippet
-$cliSnippet
-{% endtabs %}
+<Tabs>
+  $gradleSnippet
+  $mavenSnippet
+  $cliSnippet
+</Tabs>
 """.trimIndent()
         )
     }
@@ -1604,111 +1584,100 @@ $cliSnippet
         )
 
         val gradleSnippet = if (suppressGradle) "" else """
-                            {% tab title="Gradle" %}
-                            1. Add the following to your `build.gradle` file:
-                            {% code title="build.gradle" %}
-                            ```groovy
-                            plugins {
-                                id("org.openrewrite.rewrite") version("$gradlePluginVersion")
-                            }
-                            
-                            rewrite {
-                                activeRecipe("${recipeDescriptor.name}")
-                                exportDatatables = true
-                            }
-                            
-                            repositories {
-                                mavenCentral()
-                            }
-                            
-                            ```
-                            {% endcode %}
-                            2. Run `gradle rewriteRun` to run the recipe.
-                            {% endtab %}
-                            
-                            {% tab title="Gradle init script" %}
-                            1. Create a file named `init.gradle` in the root of your project.
-                            {% code title="init.gradle" %}
-                            ```groovy
-                            initscript {
-                                repositories {
-                                    maven { url "https://plugins.gradle.org/m2" }
-                                }
-                                dependencies { classpath("org.openrewrite:plugin:latest.release") }
-                            }
-                            rootProject {
-                                plugins.apply(org.openrewrite.gradle.RewritePlugin)
-                                dependencies {
-                                    rewrite("org.openrewrite:rewrite-java")
+                            <TabItem title="Gradle">
+                                1. Add the following to your `build.gradle` file:
+                                ```groovy title="build.gradle"
+                                plugins {
+                                    id("org.openrewrite.rewrite") version("$gradlePluginVersion")
                                 }
+                                
                                 rewrite {
                                     activeRecipe("${recipeDescriptor.name}")
                                     exportDatatables = true
                                 }
-                                afterEvaluate {
-                                    if (repositories.isEmpty()) {
-                                        repositories {
-                                            mavenCentral()
+                                
+                                repositories {
+                                    mavenCentral()
+                                }
+                                
+                                ```
+                                2. Run `gradle rewriteRun` to run the recipe.
+                            </TabItem>
+                            
+                            <TabItem title="Gradle init script">
+                                1. Create a file named `init.gradle` in the root of your project.
+                                ```groovy title="init.gradle"
+                                initscript {
+                                    repositories {
+                                        maven { url "https://plugins.gradle.org/m2" }
+                                    }
+                                    dependencies { classpath("org.openrewrite:plugin:latest.release") }
+                                }
+                                rootProject {
+                                    plugins.apply(org.openrewrite.gradle.RewritePlugin)
+                                    dependencies {
+                                        rewrite("org.openrewrite:rewrite-java")
+                                    }
+                                    rewrite {
+                                        activeRecipe("${recipeDescriptor.name}")
+                                        exportDatatables = true
+                                    }
+                                    afterEvaluate {
+                                        if (repositories.isEmpty()) {
+                                            repositories {
+                                                mavenCentral()
+                                            }
                                         }
                                     }
                                 }
-                            }
-                            ```
-                            {% endcode %}
-                            2. Run the recipe.
-                            {% code title="shell" overflow="wrap"%}
-                            ```shell
-                            gradle --init-script init.gradle rewriteRun
-                            ```
-                            {% endcode %}
-                            {% endtab %}
+                                ```
+                                2. Run the recipe.
+                                ```shell title="shell"
+                                gradle --init-script init.gradle rewriteRun
+                                ```
+                            </TabItem>
                             """.trimIndent()
 
         val mavenSnippet = if (suppressMaven) "" else """
-                            {% tab title="Maven POM" %}
-                            1. Add the following to your `pom.xml` file:
-                            {% code title="pom.xml" %}
-                            ```xml
-                            <project>
-                              <build>
-                                <plugins>
-                                  <plugin>
-                                    <groupId>org.openrewrite.maven</groupId>
-                                    <artifactId>rewrite-maven-plugin</artifactId>
-                                    <version>$mavenPluginVersion</version>
-                                    <configuration>
-                                      $dataTableSnippet
-                                      <activeRecipes>
-                                        <recipe>${recipeDescriptor.name}</recipe>
-                                      </activeRecipes>
-                                    </configuration>
-                                  </plugin>
-                                </plugins>
-                              </build>
-                            </project>
-                            ```
-                            {% endcode %}
-                            2. Run `mvn rewrite:run` to run the recipe.
-                            {% endtab %}
+                            <TabItem title="Maven POM">
+                                1. Add the following to your `pom.xml` file:
+                                ```xml title="pom.xml"
+                                <project>
+                                  <build>
+                                    <plugins>
+                                      <plugin>
+                                        <groupId>org.openrewrite.maven</groupId>
+                                        <artifactId>rewrite-maven-plugin</artifactId>
+                                        <version>$mavenPluginVersion</version>
+                                        <configuration>
+                                          $dataTableSnippet
+                                          <activeRecipes>
+                                            <recipe>${recipeDescriptor.name}</recipe>
+                                          </activeRecipes>
+                                        </configuration>
+                                      </plugin>
+                                    </plugins>
+                                  </build>
+                                </project>
+                                ```
+                                2. Run `mvn rewrite:run` to run the recipe.
+                            </TabItem>
                             
-                            {% tab title="Maven Command Line" %}
-
-                            You will need to have [Maven](https://maven.apache.org/download.cgi) installed on your machine before you can run the following command.
-
-                            {% code title="shell" overflow="wrap"%}
-                            ```shell
-                            mvn -U org.openrewrite.maven:rewrite-maven-plugin:run -Drewrite.activeRecipes=${recipeDescriptor.name} $dataTableCommandLineSnippet
-                            ```
-                            {% endcode %}
-                            {% endtab %}
+                            <TabItem title="Maven Command Line">
+                                You will need to have [Maven](https://maven.apache.org/download.cgi) installed on your machine before you can run the following command.
+    
+                                ```shell title="shell"
+                                mvn -U org.openrewrite.maven:rewrite-maven-plugin:run -Drewrite.activeRecipes=${recipeDescriptor.name} $dataTableCommandLineSnippet
+                                ```
+                            </TabItem>
                             """.trimIndent()
         writeln(
             """
-{% tabs %}
-$gradleSnippet
-$mavenSnippet
-$cliSnippet
-{% endtabs %}
+<Tabs>
+  $gradleSnippet
+  $mavenSnippet
+  $cliSnippet
+</Tabs>
 """.trimIndent()
         )
     }
@@ -1731,122 +1700,111 @@ $cliSnippet
         )
 
         val gradleSnippet = if (suppressGradle) "" else """
-                            {% tab title="Gradle" %}
-                            1. Add the following to your `build.gradle` file:
-                            {% code title="build.gradle" %}
-                            ```groovy
-                            plugins {
-                                id("org.openrewrite.rewrite") version("$gradlePluginVersion")
-                            }
-                            
-                            rewrite {
-                                activeRecipe("${recipeDescriptor.name}")
-                                exportDatatables = true
-                            }
-                            
-                            repositories {
-                                mavenCentral()
-                            }
-                            
-                            dependencies {
-                                rewrite("${origin.groupId}:${origin.artifactId}:${origin.version}")
-                            }
-                            ```
-                            {% endcode %}
-                            2. Run `gradle rewriteRun` to run the recipe.
-                            {% endtab %}
-                            
-                            {% tab title="Gradle init script" %}
-                            1. Create a file named `init.gradle` in the root of your project.
-                            {% code title="init.gradle" %}
-                            ```groovy
-                            initscript {
+                            <TabItem title="Gradle">
+                                1. Add the following to your `build.gradle` file:
+                                ```groovy title="build.gradle"
+                                plugins {
+                                    id("org.openrewrite.rewrite") version("$gradlePluginVersion")
+                                }
+                                
+                                rewrite {
+                                    activeRecipe("${recipeDescriptor.name}")
+                                    exportDatatables = true
+                                }
+                                
                                 repositories {
-                                    maven { url "https://plugins.gradle.org/m2" }
+                                    mavenCentral()
                                 }
-                                dependencies { classpath("org.openrewrite:plugin:${gradlePluginVersion}") }
-                            }
-                            rootProject {
-                                plugins.apply(org.openrewrite.gradle.RewritePlugin)
+                                
                                 dependencies {
                                     rewrite("${origin.groupId}:${origin.artifactId}:${origin.version}")
                                 }
-                                rewrite {
-                                    activeRecipe("${recipeDescriptor.name}")
-                                    exportDatatables = true
+                                ```
+                                2. Run `gradle rewriteRun` to run the recipe.
+                            </TabItem>
+                            
+                            <TabItem title="Gradle init script">
+                                1. Create a file named `init.gradle` in the root of your project.
+                                ```groovy title="init.gradle"
+                                initscript {
+                                    repositories {
+                                        maven { url "https://plugins.gradle.org/m2" }
+                                    }
+                                    dependencies { classpath("org.openrewrite:plugin:${gradlePluginVersion}") }
                                 }
-                                afterEvaluate {
-                                    if (repositories.isEmpty()) {
-                                        repositories {
-                                            mavenCentral()
+                                rootProject {
+                                    plugins.apply(org.openrewrite.gradle.RewritePlugin)
+                                    dependencies {
+                                        rewrite("${origin.groupId}:${origin.artifactId}:${origin.version}")
+                                    }
+                                    rewrite {
+                                        activeRecipe("${recipeDescriptor.name}")
+                                        exportDatatables = true
+                                    }
+                                    afterEvaluate {
+                                        if (repositories.isEmpty()) {
+                                            repositories {
+                                                mavenCentral()
+                                            }
                                         }
                                     }
                                 }
-                            }
-                            ```
-                            {% endcode %}
-                            2. Run the recipe.
-                            {% code title="shell" overflow="wrap"%}
-                            ```shell
-                            gradle --init-script init.gradle rewriteRun
-                            ```
-                            {% endcode %}
-                            {% endtab %}
+                                ```
+                                2. Run the recipe.
+                                ```shell title="shell"
+                                gradle --init-script init.gradle rewriteRun
+                                ```
+                            </TabItem>
                             """.trimIndent()
 
         val mavenSnippet = if (suppressMaven) "" else """
-                            {% tab title="Maven POM" %}
-                            1. Add the following to your `pom.xml` file:
-                            {% code title="pom.xml" %}
-                            ```xml
-                            <project>
-                              <build>
-                                <plugins>
-                                  <plugin>
-                                    <groupId>org.openrewrite.maven</groupId>
-                                    <artifactId>rewrite-maven-plugin</artifactId>
-                                    <version>$mavenPluginVersion</version>
-                                    <configuration>
-                                      $dataTableSnippet
-                                      <activeRecipes>
-                                        <recipe>${recipeDescriptor.name}</recipe>
-                                      </activeRecipes>
-                                    </configuration>
-                                    <dependencies>
-                                      <dependency>
-                                        <groupId>${origin.groupId}</groupId>
-                                        <artifactId>${origin.artifactId}</artifactId>
-                                        <version>${origin.version}</version>
-                                      </dependency>
-                                    </dependencies>
-                                  </plugin>
-                                </plugins>
-                              </build>
-                            </project>
-                            ```
-                            {% endcode %}
-                            2. Run `mvn rewrite:run` to run the recipe.
-                            {% endtab %}
+                            <TabItem title="Maven POM">
+                                1. Add the following to your `pom.xml` file:
+                                ```xml title="pom.xml"
+                                <project>
+                                  <build>
+                                    <plugins>
+                                      <plugin>
+                                        <groupId>org.openrewrite.maven</groupId>
+                                        <artifactId>rewrite-maven-plugin</artifactId>
+                                        <version>$mavenPluginVersion</version>
+                                        <configuration>
+                                          $dataTableSnippet
+                                          <activeRecipes>
+                                            <recipe>${recipeDescriptor.name}</recipe>
+                                          </activeRecipes>
+                                        </configuration>
+                                        <dependencies>
+                                          <dependency>
+                                            <groupId>${origin.groupId}</groupId>
+                                            <artifactId>${origin.artifactId}</artifactId>
+                                            <version>${origin.version}</version>
+                                          </dependency>
+                                        </dependencies>
+                                      </plugin>
+                                    </plugins>
+                                  </build>
+                                </project>
+                                ```
+                                2. Run `mvn rewrite:run` to run the recipe.
+                            </TabItem>
                             
-                            {% tab title="Maven Command Line" %}
-
-                            You will need to have [Maven](https://maven.apache.org/download.cgi) installed on your machine before you can run the following command.
-
-                            {% code title="shell" overflow="wrap" %}
-                            ```shell
-                            mvn -U org.openrewrite.maven:rewrite-maven-plugin:run -Drewrite.recipeArtifactCoordinates=${origin.groupId}:${origin.artifactId}:RELEASE -Drewrite.activeRecipes=${recipeDescriptor.name} $dataTableCommandLineSnippet
-                            ```
-                            {% endcode %}
-                            {% endtab %}
+                            <TabItem title="Maven Command Line">
+                                You will need to have [Maven](https://maven.apache.org/download.cgi) installed on your machine before you can run the following command.
+    
+                                ```shell title="shell"
+                                mvn -U org.openrewrite.maven:rewrite-maven-plugin:run -Drewrite.recipeArtifactCoordinates=${origin.groupId}:${origin.artifactId}:RELEASE -Drewrite.activeRecipes=${recipeDescriptor.name} $dataTableCommandLineSnippet
+                                ```
+                            </TabItem>
                             """.trimIndent()
 
         writeln(
             """
-{% tabs %}
-$gradleSnippet
-$mavenSnippet
-$cliSnippet
-{% endtabs %}
+<Tabs>
+  $gradleSnippet
+  $mavenSnippet
+  $cliSnippet
+</Tabs>
 """.trimIndent()
         )
     }

From 4787c38c2d8335fb082edc5d6df8403f91244cab Mon Sep 17 00:00:00 2001
From: Mike Solomon <mike-solomon@users.noreply.github.com>
Date: Thu, 26 Sep 2024 09:04:36 -0700
Subject: [PATCH 02/17] Saving fixes

---
 .../openrewrite/RecipeMarkdownGenerator.kt    | 180 ++++++------------
 1 file changed, 62 insertions(+), 118 deletions(-)

diff --git a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
index 3706571..8790563 100644
--- a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
+++ b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
@@ -104,7 +104,7 @@ class RecipeMarkdownGenerator : Runnable {
 
     override fun run() {
         val outputPath = Paths.get(destinationDirectoryName)
-        val recipesPath = outputPath.resolve("reference/recipes")
+        val recipesPath = outputPath.resolve("recipes")
         try {
             Files.createDirectories(recipesPath)
         } catch (e: IOException) {
@@ -321,18 +321,6 @@ class RecipeMarkdownGenerator : Runnable {
 
         val categories = Category.fromDescriptors(recipeDescriptors, categoryDescriptors).sortedBy { it.simpleName }
 
-        // Write SUMMARY_snippet.md
-        val summarySnippetPath = outputPath.resolve("SUMMARY_snippet.md")
-        Files.newBufferedWriter(summarySnippetPath, StandardOpenOption.CREATE).useAndApply {
-            for (category in categories) {
-                write(category.summarySnippet(0))
-            }
-            write("""
-                * [Changelog](changelog/changelog.md)
-                  * [$rewriteBomVersion Release (${getDateFormattedYYYYMMDD()})](/changelog/${rewriteBomVersion.replace('.','-')}-Release.md)
-                """.trimIndent())
-        }
-
         // Write recipes-with-data-tables.md
         val recipesWithDataTablesPath = outputPath.resolve("recipes-with-data-tables.md")
         Files.newBufferedWriter(recipesWithDataTablesPath, StandardOpenOption.CREATE).useAndApply {
@@ -361,7 +349,7 @@ class RecipeMarkdownGenerator : Runnable {
 
         // Write the README.md for each category
         for (category in categories) {
-            val categoryIndexPath = outputPath.resolve("reference/recipes/")
+            val categoryIndexPath = outputPath.resolve("/recipes/")
             category.writeCategoryIndex(categoryIndexPath)
         }
     }
@@ -706,49 +694,6 @@ class RecipeMarkdownGenerator : Runnable {
                 descriptor.displayName.replace("`", "")
             }
 
-        /**
-         * Produce the snippet for this category to be fitted into Gitbook's SUMMARY.md, which provides the index
-         * that makes markdown documents accessible through gitbook's interface
-         */
-        fun summarySnippet(indentationDepth: Int): String {
-            val indentBuilder = StringBuilder("  ")
-            for (i in 0 until indentationDepth) {
-                indentBuilder.append("  ")
-            }
-            val indent = indentBuilder.toString()
-            val result = StringBuilder()
-
-            if (path == "") {
-                // Recipes that don't have a path are part of the "core" set of recipes
-                result.appendLine("$indent* [Core](reference/recipes/core.md)")
-            } else {
-                // Some nested recipes have a `github` path which gets converted into `Github` when it should be `GitHub`.
-                if (displayName == "Github") {
-                    displayName = "GitHub"
-                }
-
-                result.appendLine("$indent* [$displayName](reference/recipes/$path/README.md)")
-            }
-
-            for (recipe in recipes) {
-                // Section headings will display backticks, rather than rendering as code. Omit them so it doesn't look terrible
-                result.appendLine(
-                    "$indent  * [${
-                        recipe.displayName.replace(
-                            "`",
-                            ""
-                        )
-                    }](${getRecipeRelativePath(recipe)}.md)"
-                )
-            }
-
-            for (category in subcategories.sortedBy { it.simpleName }) {
-                result.append(category.summarySnippet(indentationDepth + 1))
-            }
-
-            return result.toString()
-        }
-
         /**
          * Produce the contents of the README.md file for this category.
          */
@@ -771,7 +716,7 @@ class RecipeMarkdownGenerator : Runnable {
                     appendLine("## Categories")
                     appendLine()
                     for (subcategory in subcategories) {
-                        appendLine("* [${subcategory.displayName}](/reference/recipes/${subcategory.path})")
+                        appendLine("* [${subcategory.displayName}](/recipes/${subcategory.path})")
                     }
                     appendLine()
                 }
@@ -844,13 +789,6 @@ class RecipeMarkdownGenerator : Runnable {
                     }
                 }
 
-                // Also need to make an empty README for GitBook linking
-                val emptyReadmePath = outputRoot.resolve("README.md")
-
-                Files.newBufferedWriter(emptyReadmePath, StandardOpenOption.CREATE).useAndApply {
-                    writeln("# Recipes")
-                }
-
                 return
             }
             val outputPath = outputRoot.resolve("$path/README.md")
@@ -875,9 +813,16 @@ class RecipeMarkdownGenerator : Runnable {
         Files.newBufferedWriter(recipeMarkdownPath, StandardOpenOption.CREATE).useAndApply {
             write(
                 """
-                # ${recipeDescriptor.displayName}
+                ---
+                sidebar_label: "${recipeDescriptor.displayName.replace("`","").replace("\"", "\\\"").replace("<script>", "<script >")}"
+                ---
+
+                import Tabs from '@theme/Tabs';
+                import TabItem from '@theme/TabItem';
+
+                # ${recipeDescriptor.displayName.replace("<", "&lt;").replace(">", "&gt;")}
                 
-                **${recipeDescriptor.name.replace("_".toRegex(), "\\\\_")}**
+                **${recipeDescriptor.name.replace("_".toRegex(), "\\\\_").replace("<", "&lt;").replace(">", "&gt;")}**
                 
             """.trimIndent()
             )
@@ -885,7 +830,7 @@ class RecipeMarkdownGenerator : Runnable {
             newLine()
 
             if (!isNullOrEmpty(recipeDescriptor.description)) {
-                writeln("_" + recipeDescriptor.description.trim() + "_")
+                writeln("_" + recipeDescriptor.description.replace("<", "&lt;").replace(">", "&gt;").trim() + "_")
             }
             newLine()
             if (recipeDescriptor.tags.isNotEmpty()) {
@@ -1092,8 +1037,8 @@ class RecipeMarkdownGenerator : Runnable {
                     if (hasChange && source.before != null) {
                         newLine()
                         val tabName = source.path ?: (source.language ?: "Before / After")
-                        writeln("<Tabs>")
-                        writeln("  <TabItem value=\"${tabName}\" title=\"${tabName}\">")
+                        writeln("<Tabs groupId=\"before-after\">")
+                        writeln("<TabItem value=\"${tabName}\" title=\"${tabName}\">")
                     }
 
                     newLine()
@@ -1134,8 +1079,8 @@ class RecipeMarkdownGenerator : Runnable {
 
                         // diff
                         if (source.before != null) {
-                            writeln("  </TabItem>")
-                            writeln("<TabItem title=\"Diff\" >")
+                            writeln("</TabItem>")
+                            writeln("<TabItem value=\"diff\" title=\"Diff\" >")
 
                             val diff = generateDiff(source.path, source.before, source.after)
 
@@ -1276,8 +1221,8 @@ class RecipeMarkdownGenerator : Runnable {
                         
                         ## Definition
                         
-                        <Tab>
-                          <TabItem title="Recipe List" >
+                        <Tabs groupId="recipe-type">
+                        <TabItem value="recipe-list" title="Recipe List" >
                     """.trimIndent()
             )
             val recipeDepth = getRecipePath(recipeDescriptor).chars().filter { ch: Int -> ch == '/'.code }.count()
@@ -1292,21 +1237,14 @@ class RecipeMarkdownGenerator : Runnable {
                     continue
                 }
 
-                writeln("* [" + recipe.displayName + "](" + pathToRecipes + getRecipePath(recipe) + ".md)")
-                if (recipe.options.isNotEmpty()) {
-                    for (option in recipe.options) {
-                        if (option.value != null) {
-                            writeln("  * " + option.name + ": `" + printValue(option.value!!) + "`")
-                        }
-                    }
-                }
+                writeln("    * [" + recipe.displayName + "](" + pathToRecipes + getRecipePath(recipe) + ".md)")
             }
             newLine()
             writeln(
                 """
-                          </TabItem>
+                        </TabItem>
     
-                          <TabItem title="Yaml Recipe List">
+                        <TabItem value="yaml-recipe-list" title="Yaml Recipe List">
                         ```yaml
                     """.trimIndent()
             )
@@ -1314,7 +1252,7 @@ class RecipeMarkdownGenerator : Runnable {
             writeln(
                 """
                         ```
-                          </TabItem>
+                        </TabItem>
                         </Tabs>
                     """.trimIndent()
             )
@@ -1326,9 +1264,15 @@ class RecipeMarkdownGenerator : Runnable {
             """
 
                     ## See how this recipe works across multiple open-source repositories
-    
-                    [![Moderne Link Image](/.gitbook/assets/ModerneRecipeButton.png)](https://app.moderne.io/recipes/${recipeDescriptor.name})
-    
+                    
+                    <a href="https://app.moderne.io/recipes/${recipeDescriptor.name}">
+                        <img
+                        src={require("/static/img/ModerneRecipeButton.png").default}
+                        alt="Moderne Link Image"
+                        width="50%"
+                        />
+                    </a>
+        
                     The community edition of the Moderne platform enables you to easily run recipes across thousands of open-source repositories.
     
                     Please [contact Moderne](https://moderne.io/product) for more information about safely running the recipes on your own codebase in a private SaaS.
@@ -1410,7 +1354,7 @@ class RecipeMarkdownGenerator : Runnable {
         }
 
         return """
-                <TabItem title="Moderne CLI">
+                <TabItem value="moderne-cli" title="Moderne CLI">
                     You will need to have configured the [Moderne CLI](https://docs.moderne.io/moderne-cli/cli-intro) on your machine before you can run the following command.
     
                     ```shell title="shell"
@@ -1430,7 +1374,7 @@ class RecipeMarkdownGenerator : Runnable {
         dataTableSnippet: String,
     ) {
         val gradleSnippet = if (suppressGradle) "" else """
-                            <TabItem title="Gradle">
+                            <TabItem value="gradle" title="Gradle">
                                 1. Add the following to your `build.gradle` file:
                                 ```groovy title="build.gradle"
                                 plugins {
@@ -1451,7 +1395,7 @@ class RecipeMarkdownGenerator : Runnable {
                             """.trimIndent()
 
         val mavenSnippet = if (suppressMaven) "" else """
-                            <TabItem title="Maven">
+                            <TabItem value="maven" title="Maven">
                                 1. Add the following to your `pom.xml` file:
                                 ```xml title="pom.xml"
                                 <project>
@@ -1479,10 +1423,10 @@ class RecipeMarkdownGenerator : Runnable {
         writeln(
             """
 Now that `$exampleRecipeName` has been defined, activate it in your build file:
-<Tabs>
-  $gradleSnippet
-  $mavenSnippet
-  $cliSnippet
+<Tabs groupId="project-type">
+$gradleSnippet
+$mavenSnippet
+$cliSnippet
 </Tabs>
 """.trimIndent()
         )
@@ -1499,7 +1443,7 @@ Now that `$exampleRecipeName` has been defined, activate it in your build file:
         dataTableSnippet: String,
     ) {
         val gradleSnippet = if (suppressGradle) "" else """
-                            <TabItem title="Gradle">
+                            <TabItem value="gradle" title="Gradle">
                                 1. Add the following to your `build.gradle` file:
                                 ```groovy title="build.gradle"
                                 plugins {
@@ -1524,7 +1468,7 @@ Now that `$exampleRecipeName` has been defined, activate it in your build file:
                             """.trimIndent()
 
         val mavenSnippet = if (suppressMaven) "" else """
-                            <TabItem title="Maven">
+                            <TabItem value="maven" title="Maven">
                                 1. Add the following to your `pom.xml` file:
                                 ```xml title="pom.xml"
                                 <project>
@@ -1559,10 +1503,10 @@ Now that `$exampleRecipeName` has been defined, activate it in your build file:
         writeln(
             """
 Now that `$exampleRecipeName` has been defined, activate it and take a dependency on ${origin.groupId}:${origin.artifactId}:${origin.version} in your build file:
-<Tabs>
-  $gradleSnippet
-  $mavenSnippet
-  $cliSnippet
+<Tabs groupId="project-type">
+$gradleSnippet
+$mavenSnippet
+$cliSnippet
 </Tabs>
 """.trimIndent()
         )
@@ -1584,7 +1528,7 @@ Now that `$exampleRecipeName` has been defined, activate it and take a dependenc
         )
 
         val gradleSnippet = if (suppressGradle) "" else """
-                            <TabItem title="Gradle">
+                            <TabItem value="gradle" title="Gradle">
                                 1. Add the following to your `build.gradle` file:
                                 ```groovy title="build.gradle"
                                 plugins {
@@ -1604,7 +1548,7 @@ Now that `$exampleRecipeName` has been defined, activate it and take a dependenc
                                 2. Run `gradle rewriteRun` to run the recipe.
                             </TabItem>
                             
-                            <TabItem title="Gradle init script">
+                            <TabItem value="gradle-init-script" title="Gradle init script">
                                 1. Create a file named `init.gradle` in the root of your project.
                                 ```groovy title="init.gradle"
                                 initscript {
@@ -1639,7 +1583,7 @@ Now that `$exampleRecipeName` has been defined, activate it and take a dependenc
                             """.trimIndent()
 
         val mavenSnippet = if (suppressMaven) "" else """
-                            <TabItem title="Maven POM">
+                            <TabItem value="maven" title="Maven POM">
                                 1. Add the following to your `pom.xml` file:
                                 ```xml title="pom.xml"
                                 <project>
@@ -1663,7 +1607,7 @@ Now that `$exampleRecipeName` has been defined, activate it and take a dependenc
                                 2. Run `mvn rewrite:run` to run the recipe.
                             </TabItem>
                             
-                            <TabItem title="Maven Command Line">
+                            <TabItem value="maven-command-line" title="Maven Command Line">
                                 You will need to have [Maven](https://maven.apache.org/download.cgi) installed on your machine before you can run the following command.
     
                                 ```shell title="shell"
@@ -1673,10 +1617,10 @@ Now that `$exampleRecipeName` has been defined, activate it and take a dependenc
                             """.trimIndent()
         writeln(
             """
-<Tabs>
-  $gradleSnippet
-  $mavenSnippet
-  $cliSnippet
+<Tabs groupId="project-type">
+$gradleSnippet
+$mavenSnippet
+$cliSnippet
 </Tabs>
 """.trimIndent()
         )
@@ -1700,7 +1644,7 @@ Now that `$exampleRecipeName` has been defined, activate it and take a dependenc
         )
 
         val gradleSnippet = if (suppressGradle) "" else """
-                            <TabItem title="Gradle">
+                            <TabItem value="gradle" title="Gradle">
                                 1. Add the following to your `build.gradle` file:
                                 ```groovy title="build.gradle"
                                 plugins {
@@ -1723,7 +1667,7 @@ Now that `$exampleRecipeName` has been defined, activate it and take a dependenc
                                 2. Run `gradle rewriteRun` to run the recipe.
                             </TabItem>
                             
-                            <TabItem title="Gradle init script">
+                            <TabItem value="gradle-init-script" title="Gradle init script">
                                 1. Create a file named `init.gradle` in the root of your project.
                                 ```groovy title="init.gradle"
                                 initscript {
@@ -1758,7 +1702,7 @@ Now that `$exampleRecipeName` has been defined, activate it and take a dependenc
                             """.trimIndent()
 
         val mavenSnippet = if (suppressMaven) "" else """
-                            <TabItem title="Maven POM">
+                            <TabItem value="maven" title="Maven POM">
                                 1. Add the following to your `pom.xml` file:
                                 ```xml title="pom.xml"
                                 <project>
@@ -1789,7 +1733,7 @@ Now that `$exampleRecipeName` has been defined, activate it and take a dependenc
                                 2. Run `mvn rewrite:run` to run the recipe.
                             </TabItem>
                             
-                            <TabItem title="Maven Command Line">
+                            <TabItem value="maven-command-line" title="Maven Command Line">
                                 You will need to have [Maven](https://maven.apache.org/download.cgi) installed on your machine before you can run the following command.
     
                                 ```shell title="shell"
@@ -1800,10 +1744,10 @@ Now that `$exampleRecipeName` has been defined, activate it and take a dependenc
 
         writeln(
             """
-<Tabs>
-  $gradleSnippet
-  $mavenSnippet
-  $cliSnippet
+<Tabs groupId="project-type">
+$gradleSnippet
+$mavenSnippet
+$cliSnippet
 </Tabs>
 """.trimIndent()
         )
@@ -1858,7 +1802,7 @@ Now that `$exampleRecipeName` has been defined, activate it and take a dependenc
             recipesPath.resolve(getRecipePath(recipeDescriptor) + ".md")
 
         private fun getRecipeRelativePath(recipe: RecipeDescriptor): String =
-            "reference/recipes/" + getRecipePath(recipe)
+            "/recipes/" + getRecipePath(recipe)
 
         private fun findCategoryDescriptor(
             categoryPathFragment: String,

From ce61d416180b8bcb6cf55754dfebc23b6ec46f47 Mon Sep 17 00:00:00 2001
From: Mike Solomon <mike-solomon@users.noreply.github.com>
Date: Thu, 26 Sep 2024 12:22:07 -0700
Subject: [PATCH 03/17] More docusaurus fixes

---
 .../openrewrite/RecipeDescriptorExtensions.kt |  10 +-
 .../openrewrite/RecipeMarkdownGenerator.kt    | 145 ++++++++++++------
 2 files changed, 103 insertions(+), 52 deletions(-)

diff --git a/src/main/kotlin/org/openrewrite/RecipeDescriptorExtensions.kt b/src/main/kotlin/org/openrewrite/RecipeDescriptorExtensions.kt
index d284d29..0813140 100755
--- a/src/main/kotlin/org/openrewrite/RecipeDescriptorExtensions.kt
+++ b/src/main/kotlin/org/openrewrite/RecipeDescriptorExtensions.kt
@@ -6,11 +6,11 @@ import org.openrewrite.config.RecipeDescriptor
 fun RecipeDescriptor.asYaml(): String {
     val s = StringBuilder()
     s.appendLine("""
-        ---
-        type: specs.openrewrite.org/v1beta/recipe
-        name: $name
-        displayName: $displayName
-        description: $description
+---
+type: specs.openrewrite.org/v1beta/recipe
+name: $name
+displayName: $displayName
+description: ${description?.replace("\n", " – ") ?: ""}
     """.trimIndent())
     if (tags.isNotEmpty()) {
         s.appendLine("tags:")
diff --git a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
index 8790563..feda01c 100644
--- a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
+++ b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
@@ -119,34 +119,7 @@ class RecipeMarkdownGenerator : Runnable {
             recipeOrigins = RecipeOrigin.parse(recipeSources)
 
             // Write latest-versions-of-every-openrewrite-module.md
-            val versionsSnippetPath = outputPath.resolve("latest-versions-of-every-openrewrite-module.md")
-            Files.newBufferedWriter(versionsSnippetPath, StandardOpenOption.CREATE).useAndApply {
-                val bomLink = "[${rewriteRecipeBomVersion}](https://github.com/openrewrite/rewrite-recipe-bom/releases/tag/v${rewriteRecipeBomVersion})"
-                val mavenLink = "[${mavenPluginVersion}](https://github.com/openrewrite/rewrite-maven-plugin/releases/tag/v${mavenPluginVersion})"
-                val gradleLink = "[${gradlePluginVersion}](https://github.com/openrewrite/rewrite-gradle-plugin/releases/tag/v${gradlePluginVersion})"
-                writeln("""
-                    # Latest versions of every OpenRewrite module
-                    
-                    OpenRewrite's modules are published to [Maven Central](https://search.maven.org/search?q=org.openrewrite).
-                    Each time a release is made, a bill of materials artifact is also published to correctly align and manage the versions of all published artifacts.
-                    The Gradle plugin is published to the [Gradle Plugin Portal](https://plugins.gradle.org/plugin/org.openrewrite.rewrite).
-                    
-                    It is highly recommended that developers use the [rewrite-recipe-bom](https://github.com/openrewrite/rewrite-recipe-bom)
-                    to align the versions of Rewrite's modules to ensure compatibility.
-                    The use of the "bill of materials" means that a developer will only need to specify explicit versions of the BOM and the build plugins:
-                    
-                    | Module                                                                                                                | Version    |
-                    |-----------------------------------------------------------------------------------------------------------------------| ---------- |
-                    | [**org.openrewrite.recipe:rewrite-recipe-bom**](https://github.com/openrewrite/rewrite-recipe-bom)                    | **${bomLink}** |
-                    | [**org.openrewrite:rewrite-maven-plugin**](https://github.com/openrewrite/rewrite-maven-plugin)                       | **${mavenLink}** |
-                    | [**org.openrewrite:rewrite-gradle-plugin**](https://github.com/openrewrite/rewrite-gradle-plugin)                     | **${gradleLink}** |
-                    """.trimIndent())
-                for (recipeOrigin in recipeOrigins.values) {
-                    val repoLink = "[${recipeOrigin.groupId}:${recipeOrigin.artifactId}](${recipeOrigin.githubUrl()})"
-                    val releaseLink = "[${recipeOrigin.version}](${recipeOrigin.githubUrl()}/releases/tag/v${recipeOrigin.version})"
-                    writeln("| ${repoLink.padEnd(117)} | ${releaseLink} |")
-                }
-            }
+            createLatestVersionsFile(outputPath, recipeOrigins)
 
             val classloader = recipeClasspath.split(";")
                 .map(Paths::get)
@@ -349,11 +322,51 @@ class RecipeMarkdownGenerator : Runnable {
 
         // Write the README.md for each category
         for (category in categories) {
-            val categoryIndexPath = outputPath.resolve("/recipes/")
+            val categoryIndexPath = outputPath.resolve("recipes/")
             category.writeCategoryIndex(categoryIndexPath)
         }
     }
 
+    private fun createLatestVersionsFile(
+        outputPath: Path,
+        recipeOrigins: Map<URI, RecipeOrigin>
+    ) {
+        val versionsSnippetPath = outputPath.resolve("latest-versions-of-every-openrewrite-module.md")
+        Files.newBufferedWriter(versionsSnippetPath, StandardOpenOption.CREATE).useAndApply {
+            val bomLink =
+                "[${rewriteRecipeBomVersion}](https://github.com/openrewrite/rewrite-recipe-bom/releases/tag/v${rewriteRecipeBomVersion})"
+            val mavenLink =
+                "[${mavenPluginVersion}](https://github.com/openrewrite/rewrite-maven-plugin/releases/tag/v${mavenPluginVersion})"
+            val gradleLink =
+                "[${gradlePluginVersion}](https://github.com/openrewrite/rewrite-gradle-plugin/releases/tag/v${gradlePluginVersion})"
+            writeln(
+                """
+                        # Latest versions of every OpenRewrite module
+
+                        OpenRewrite's modules are published to [Maven Central](https://search.maven.org/search?q=org.openrewrite).
+                        Each time a release is made, a bill of materials artifact is also published to correctly align and manage the versions of all published artifacts.
+                        The Gradle plugin is published to the [Gradle Plugin Portal](https://plugins.gradle.org/plugin/org.openrewrite.rewrite).
+
+                        It is highly recommended that developers use the [rewrite-recipe-bom](https://github.com/openrewrite/rewrite-recipe-bom)
+                        to align the versions of Rewrite's modules to ensure compatibility.
+                        The use of the "bill of materials" means that a developer will only need to specify explicit versions of the BOM and the build plugins:
+
+                        | Module                                                                                                                | Version    |
+                        |-----------------------------------------------------------------------------------------------------------------------| ---------- |
+                        | [**org.openrewrite.recipe:rewrite-recipe-bom**](https://github.com/openrewrite/rewrite-recipe-bom)                    | **${bomLink}** |
+                        | [**org.openrewrite:rewrite-maven-plugin**](https://github.com/openrewrite/rewrite-maven-plugin)                       | **${mavenLink}** |
+                        | [**org.openrewrite:rewrite-gradle-plugin**](https://github.com/openrewrite/rewrite-gradle-plugin)                     | **${gradleLink}** |
+                        """.trimIndent()
+            )
+            for (recipeOrigin in recipeOrigins.values) {
+                val repoLink = "[${recipeOrigin.groupId}:${recipeOrigin.artifactId}](${recipeOrigin.githubUrl()})"
+                val releaseLink =
+                    "[${recipeOrigin.version}](${recipeOrigin.githubUrl()}/releases/tag/v${recipeOrigin.version})"
+                writeln("| ${repoLink.padEnd(117)} | ${releaseLink} |")
+            }
+        }
+    }
+
     private fun getNewArtifacts(
         markdownArtifacts: TreeMap<String, MarkdownRecipeArtifact>,
         oldArtifacts: TreeMap<String, MarkdownRecipeArtifact>,
@@ -741,10 +754,13 @@ class RecipeMarkdownGenerator : Runnable {
 
                         for (recipe in compositeRecipes) {
                             val recipeSimpleName = recipe.name.substring(recipe.name.lastIndexOf('.') + 1).lowercase()
+                            val formattedDisplayName = recipe.displayName
+                                .replace("<script>", "\\<script\\>")
+                                .replace("<p>", "< p >")
 
                             // Anything except a relative link ending in .md will be mangled.
                             // If you touch this line double check that it works when imported into gitbook
-                            appendLine("* [${recipe.displayName}](./${recipeSimpleName}.md)")
+                            appendLine("* [${formattedDisplayName}](./${recipeSimpleName}.md)")
                         }
 
                         appendLine()
@@ -756,10 +772,13 @@ class RecipeMarkdownGenerator : Runnable {
 
                         for (recipe in normalRecipes) {
                             val recipeSimpleName = recipe.name.substring(recipe.name.lastIndexOf('.') + 1).lowercase()
+                            val formattedDisplayName = recipe.displayName
+                                .replace("<script>", "\\<script\\>")
+                                .replace("<p>", "< p >")
 
                             // Anything except a relative link ending in .md will be mangled.
                             // If you touch this line double check that it works when imported into gitbook
-                            appendLine("* [${recipe.displayName}](./${recipeSimpleName}.md)")
+                            appendLine("* [${formattedDisplayName}](./${recipeSimpleName}.md)")
                         }
 
                         appendLine()
@@ -784,8 +803,11 @@ class RecipeMarkdownGenerator : Runnable {
 
                     for (recipe in recipes) {
                         val recipeSimpleName = recipe.name.substring(recipe.name.lastIndexOf('.') + 1).lowercase()
+                        val formattedDisplayName = recipe.displayName
+                            .replace("<", "\\<")
+                            .replace(">", "\\>")
 
-                        writeln("* [${recipe.displayName}](./${recipeSimpleName}.md)")
+                        writeln("* [${formattedDisplayName}](./${recipeSimpleName}.md)")
                     }
                 }
 
@@ -808,29 +830,57 @@ class RecipeMarkdownGenerator : Runnable {
         gradlePluginVersion: String,
         mavenPluginVersion: String
     ) {
+        val sidebarFormattedName = recipeDescriptor.displayName
+            .replace("`","")
+            .replace("\"", "\\\"")
+            .replace("<script>", "<script >")
+            .replace("<p>", "< p >")
+            .trim()
+
+        val formattedRecipeTitle = recipeDescriptor?.displayName
+            ?.replace("`<", "&lt;")
+            ?.replace(">`", "&gt;")
+            ?.replace("<", "&lt;")
+            ?.replace(">", "&gt;")
+            ?.trim()
+
+        val formattedRecipeDescription = "_" +
+                recipeDescriptor?.description
+                    ?.replace("`<", "&lt;")
+                    ?.replace(">`", "&gt;")
+                    ?.replace("<", "&lt;")
+                    ?.replace(">", "&gt;")
+                    ?.replace("{", "&lcub;")
+                    ?.replace("}", "&rcub;")
+                    ?.replace("\n", " ")
+                    ?.trim() +
+                    "_"
+
+        val formattedLongRecipeName = recipeDescriptor.name.replace("_".toRegex(), "\\\\_").trim()
+
         val recipeMarkdownPath = getRecipePath(outputPath, recipeDescriptor)
         Files.createDirectories(recipeMarkdownPath.parent)
         Files.newBufferedWriter(recipeMarkdownPath, StandardOpenOption.CREATE).useAndApply {
             write(
-                """
-                ---
-                sidebar_label: "${recipeDescriptor.displayName.replace("`","").replace("\"", "\\\"").replace("<script>", "<script >")}"
-                ---
+"""
+---
+sidebar_label: "$sidebarFormattedName"
+---
+
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
-                import Tabs from '@theme/Tabs';
-                import TabItem from '@theme/TabItem';
+# $formattedRecipeTitle
+
+**$formattedLongRecipeName**
 
-                # ${recipeDescriptor.displayName.replace("<", "&lt;").replace(">", "&gt;")}
-                
-                **${recipeDescriptor.name.replace("_".toRegex(), "\\\\_").replace("<", "&lt;").replace(">", "&gt;")}**
-                
             """.trimIndent()
             )
 
             newLine()
 
             if (!isNullOrEmpty(recipeDescriptor.description)) {
-                writeln("_" + recipeDescriptor.description.replace("<", "&lt;").replace(">", "&gt;").trim() + "_")
+                writeln(formattedRecipeDescription)
             }
             newLine()
             if (recipeDescriptor.tags.isNotEmpty()) {
@@ -1237,7 +1287,11 @@ class RecipeMarkdownGenerator : Runnable {
                     continue
                 }
 
-                writeln("    * [" + recipe.displayName + "](" + pathToRecipes + getRecipePath(recipe) + ".md)")
+                val formattedRecipeDisplayName = recipe.displayName
+                    .replace("<p>", "< p >")
+                    .replace("<script>", "//<script//>")
+
+                writeln("    * [" + formattedRecipeDisplayName + "](" + pathToRecipes + getRecipePath(recipe) + ")")
             }
             newLine()
             writeln(
@@ -1801,9 +1855,6 @@ $cliSnippet
         private fun getRecipePath(recipesPath: Path, recipeDescriptor: RecipeDescriptor) =
             recipesPath.resolve(getRecipePath(recipeDescriptor) + ".md")
 
-        private fun getRecipeRelativePath(recipe: RecipeDescriptor): String =
-            "/recipes/" + getRecipePath(recipe)
-
         private fun findCategoryDescriptor(
             categoryPathFragment: String,
             categoryDescriptors: Iterable<CategoryDescriptor>

From 00e32add5e137063808c7c2e2e075d6b2892105c Mon Sep 17 00:00:00 2001
From: Mike Solomon <mike-solomon@users.noreply.github.com>
Date: Fri, 27 Sep 2024 07:41:13 -0700
Subject: [PATCH 04/17] Fix link

---
 src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
index feda01c..4ac2bb5 100644
--- a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
+++ b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
@@ -962,7 +962,7 @@ import TabItem from '@theme/TabItem';
                 }
                 // This should preserve casing and plurality
                 description = description.replace("method patterns?".toRegex(RegexOption.IGNORE_CASE)) { match ->
-                    "[${match.value}](/reference/method-patterns.md)"
+                    "[${match.value}](/reference/method-patterns)"
                 }
                 // Add valid options to description
                 if (option.valid?.isNotEmpty() ?: false) {

From 28a9d47e90378637b963ef4378c4bc268d04f483 Mon Sep 17 00:00:00 2001
From: Mike Solomon <mike-solomon@users.noreply.github.com>
Date: Fri, 27 Sep 2024 09:23:28 -0700
Subject: [PATCH 05/17] Fix core recipe generation

---
 .../openrewrite/RecipeMarkdownGenerator.kt    | 21 +++++++++++++++++--
 1 file changed, 19 insertions(+), 2 deletions(-)

diff --git a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
index 4ac2bb5..ca26e73 100644
--- a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
+++ b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
@@ -790,8 +790,16 @@ class RecipeMarkdownGenerator : Runnable {
 
         fun writeCategoryIndex(outputRoot: Path) {
             if (path.isBlank()) {
+                // Create a core directory
+                val recipesPath = outputRoot.resolve("core")
+                try {
+                    Files.createDirectories(recipesPath)
+                } catch (e: IOException) {
+                    throw RuntimeException(e)
+                }
+
                 // "Core" recipes need to be handled differently as they do not have a path like other recipes.
-                val corePath = outputRoot.resolve("core.md")
+                val corePath = outputRoot.resolve("core/README.md")
 
                 Files.newBufferedWriter(corePath, StandardOpenOption.CREATE).useAndApply {
                     writeln("# Core Recipes")
@@ -813,10 +821,12 @@ class RecipeMarkdownGenerator : Runnable {
 
                 return
             }
+
             val outputPath = outputRoot.resolve("$path/README.md")
             Files.newBufferedWriter(outputPath, StandardOpenOption.CREATE).useAndApply {
                 writeln(categoryIndex())
             }
+
             for (subcategory in subcategories) {
                 subcategory.writeCategoryIndex(outputRoot)
             }
@@ -1837,7 +1847,14 @@ $cliSnippet
 
         private fun getRecipePath(recipe: RecipeDescriptor): String =
             if (recipe.name.startsWith("org.openrewrite")) {
-                recipe.name.substring(16).replace("\\.".toRegex(), "/").lowercase(Locale.getDefault())
+                // If the recipe path only has two periods, it's part of the core recipes and should be adjusted accordingly.
+                if (recipe.name.count{ it == '.' } == 2) {
+                    "core/" + recipe.name
+                        .substring(16)
+                        .lowercase(Locale.getDefault())
+                } else {
+                    recipe.name.substring(16).replace("\\.".toRegex(), "/").lowercase(Locale.getDefault())
+                }
             } else if (recipe.name.startsWith("io.moderne")) {
                 recipe.name.substring(11).replace("\\.".toRegex(), "/").lowercase(Locale.getDefault())
             } else if (

From 38841890a37f6eba8e01926da617c10ef642d81d Mon Sep 17 00:00:00 2001
From: Mike Solomon <mike-solomon@users.noreply.github.com>
Date: Fri, 27 Sep 2024 10:30:27 -0700
Subject: [PATCH 06/17] Fix vars + options

---
 .../openrewrite/RecipeMarkdownGenerator.kt    | 20 ++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
index ca26e73..648e31c 100644
--- a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
+++ b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
@@ -964,6 +964,13 @@ import TabItem from '@theme/TabItem';
                     ""
                 } else {
                     option.description.replace("\n", "<br />")
+
+                    // Ensure that anything that matches ${variable} is wrapped in ``
+                    // Otherwise Docusaurus tries to parse it as a variable.
+                    val regex = Regex("(?<!`)\\$\\{[^}]+}(?!`)")
+                    option.description.replace(regex) { matchResult ->
+                        "`${matchResult.value}`"
+                    }
                 }
                 description = if (option.isRequired) {
                     description
@@ -1301,7 +1308,18 @@ import TabItem from '@theme/TabItem';
                     .replace("<p>", "< p >")
                     .replace("<script>", "//<script//>")
 
-                writeln("    * [" + formattedRecipeDisplayName + "](" + pathToRecipes + getRecipePath(recipe) + ")")
+                writeln("* [" + formattedRecipeDisplayName + "](" + pathToRecipes + getRecipePath(recipe) + ")")
+                if (recipe.options.isNotEmpty()) {
+                    for (option in recipe.options) {
+                        if (option.value != null) {
+                            val formattedOptionString = printValue(option.value!!)
+                                .replace("<p>", "< p >")
+                                .replace("\n", " ")
+
+                            writeln("  * " + option.name + ": `" + formattedOptionString + "`")
+                        }
+                    }
+                }
             }
             newLine()
             writeln(

From 65e4648b7b81b49b944bf15cb8df3e72278243bf Mon Sep 17 00:00:00 2001
From: Mike Solomon <mike-solomon@users.noreply.github.com>
Date: Mon, 30 Sep 2024 08:25:28 -0700
Subject: [PATCH 07/17] Fix assertj issues

---
 .../org/openrewrite/RecipeMarkdownGenerator.kt   | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
index 648e31c..bdb2ea6 100644
--- a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
+++ b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
@@ -753,11 +753,18 @@ class RecipeMarkdownGenerator : Runnable {
                         appendLine()
 
                         for (recipe in compositeRecipes) {
-                            val recipeSimpleName = recipe.name.substring(recipe.name.lastIndexOf('.') + 1).lowercase()
+                            var recipeSimpleName = recipe.name.substring(recipe.name.lastIndexOf('.') + 1).lowercase()
                             val formattedDisplayName = recipe.displayName
                                 .replace("<script>", "\\<script\\>")
                                 .replace("<p>", "< p >")
 
+                            // Docusaurus expects that if a file is called "assertj" inside of the folder "assertj" that it's the
+                            // README for said folder. Due to how generic we've made this recipe name, we need to change it for the
+                            // docs so that they parse correctly.
+                            if (recipe.name == "org.openrewrite.java.testing.assertj.Assertj") {
+                                recipeSimpleName = "assertj-best-practices"
+                            }
+
                             // Anything except a relative link ending in .md will be mangled.
                             // If you touch this line double check that it works when imported into gitbook
                             appendLine("* [${formattedDisplayName}](./${recipeSimpleName}.md)")
@@ -1864,7 +1871,12 @@ $cliSnippet
         }
 
         private fun getRecipePath(recipe: RecipeDescriptor): String =
-            if (recipe.name.startsWith("org.openrewrite")) {
+            // Docusaurus expects that if a file is called "assertj" inside of the folder "assertj" that it's the
+            // README for said folder. Due to how generic we've made this recipe name, we need to change it for the
+            // docs so that they parse correctly.
+            if (recipe.name == "org.openrewrite.java.testing.assertj.Assertj") {
+                "java/testing/assertj/assertj-best-practices"
+            } else if (recipe.name.startsWith("org.openrewrite")) {
                 // If the recipe path only has two periods, it's part of the core recipes and should be adjusted accordingly.
                 if (recipe.name.count{ it == '.' } == 2) {
                     "core/" + recipe.name

From a5d138501f7fb35b95167f7e435e162ab6a55f87 Mon Sep 17 00:00:00 2001
From: Mike Solomon <mike-solomon@users.noreply.github.com>
Date: Mon, 30 Sep 2024 08:32:52 -0700
Subject: [PATCH 08/17] Remove auto-generated github pages

Don't see a point for this anymore - and it would be a decent
amount of work to get it working again. We can easily start up
a docusaurus server locally with the changes if we want to see them.
---
 .github/workflows/pages.yml | 58 -------------------------------------
 1 file changed, 58 deletions(-)
 delete mode 100644 .github/workflows/pages.yml

diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml
deleted file mode 100644
index 4d27f8f..0000000
--- a/.github/workflows/pages.yml
+++ /dev/null
@@ -1,58 +0,0 @@
-# Simple workflow for deploying static content to GitHub Pages
-name: Deploy static content to Pages
-
-on:
-  push:
-    branches:
-      - main
-    tags-ignore:
-      - "*"
-  pull_request:
-    branches:
-      - main
-  workflow_dispatch: {}
-
-# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
-permissions:
-  contents: read
-  pages: write
-  id-token: write
-
-# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
-# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
-concurrency:
-  group: "pages"
-  cancel-in-progress: false
-
-jobs:
-  # Single deploy job since we're just deploying
-  deploy:
-    if: ${{ github.repository_owner == 'openrewrite' }}
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-      - uses: actions/setup-java@v4
-        with:
-          distribution: temurin
-          java-version: 17
-      - uses: gradle/actions/setup-gradle@v4
-      - name: build
-        run: ./gradlew ${{ env.GRADLE_SWITCHES }} run
-
-      - name: Create index.html
-        run: cp build/docs/SUMMARY_snippet.md build/docs/index.md
-
-      - name: Setup Pages
-        uses: actions/configure-pages@v5
-      - name: Upload artifact
-        uses: actions/upload-pages-artifact@v3
-        with:
-          # Upload entire repository
-          path: 'build/docs'
-      - name: Deploy to GitHub Pages
-        id: deployment
-        uses: actions/deploy-pages@v4

From 5eaf14bec5bfccc16325504c40c75c7226d2e30a Mon Sep 17 00:00:00 2001
From: Mike Solomon <mike-solomon@users.noreply.github.com>
Date: Mon, 30 Sep 2024 08:55:01 -0700
Subject: [PATCH 09/17] Make recipes with data tables look better

---
 src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
index bdb2ea6..a393fb5 100644
--- a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
+++ b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
@@ -304,9 +304,10 @@ class RecipeMarkdownGenerator : Runnable {
                     "it won't be included in this list._\n")
 
             for (recipe in recipesWithDataTables) {
-                writeln("**[${recipe.displayName}](https://docs.openrewrite.org/?q=${recipe.name})**  ")
-                writeln("**${recipe.name}**  ")
+                writeln("### [${recipe.displayName}](https://docs.openrewrite.org/?q=${recipe.name})\n ")
+                writeln("_${recipe.name}_\n")
                 writeln("${recipe.description}\n")
+                writeln("#### Data tables:\n")
 
                 val filteredDataTables = recipe.dataTables.filter { dataTable ->
                     dataTable.name !in dataTablesToIgnore

From ea709f050f23fecaac2a1d5e3339e58bfc32e117 Mon Sep 17 00:00:00 2001
From: Mike Solomon <mike-solomon@users.noreply.github.com>
Date: Wed, 2 Oct 2024 10:51:59 -0700
Subject: [PATCH 10/17] Handle more bad recipe names

---
 .../openrewrite/RecipeMarkdownGenerator.kt    | 20 +++++++++++++++----
 1 file changed, 16 insertions(+), 4 deletions(-)

diff --git a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
index a393fb5..f6b83a4 100644
--- a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
+++ b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
@@ -759,11 +759,17 @@ class RecipeMarkdownGenerator : Runnable {
                                 .replace("<script>", "\\<script\\>")
                                 .replace("<p>", "< p >")
 
+                            val recipePathToDocusaurusRenamedPath: Map<String, String> = mapOf(
+                                "org.openrewrite.java.testing.assertj.Assertj" to "assertj-best-practices",
+                                "org.openrewrite.java.migrate.javaee7" to "javaee7-recipe",
+                                "org.openrewrite.java.migrate.javaee8" to "javaee8-recipe"
+                            )
+
                             // Docusaurus expects that if a file is called "assertj" inside of the folder "assertj" that it's the
                             // README for said folder. Due to how generic we've made this recipe name, we need to change it for the
                             // docs so that they parse correctly.
-                            if (recipe.name == "org.openrewrite.java.testing.assertj.Assertj") {
-                                recipeSimpleName = "assertj-best-practices"
+                            if (recipePathToDocusaurusRenamedPath.containsKey(recipe.name)) {
+                                recipeSimpleName = recipePathToDocusaurusRenamedPath[recipe.name]!!
                             }
 
                             // Anything except a relative link ending in .md will be mangled.
@@ -1871,12 +1877,18 @@ $cliSnippet
             }
         }
 
+        private val recipePathToDocusaurusRenamedPath: Map<String, String> = mapOf(
+            "org.openrewrite.java.testing.assertj.Assertj" to "java/testing/assertj/assertj-best-practices",
+            "org.openrewrite.java.migrate.javaee7" to "java/migrate/javaee7-recipe",
+            "org.openrewrite.java.migrate.javaee8" to "java/migrate/javaee8-recipe"
+        )
+
         private fun getRecipePath(recipe: RecipeDescriptor): String =
             // Docusaurus expects that if a file is called "assertj" inside of the folder "assertj" that it's the
             // README for said folder. Due to how generic we've made this recipe name, we need to change it for the
             // docs so that they parse correctly.
-            if (recipe.name == "org.openrewrite.java.testing.assertj.Assertj") {
-                "java/testing/assertj/assertj-best-practices"
+            if (recipePathToDocusaurusRenamedPath.containsKey(recipe.name)) {
+                recipePathToDocusaurusRenamedPath[recipe.name]!!
             } else if (recipe.name.startsWith("org.openrewrite")) {
                 // If the recipe path only has two periods, it's part of the core recipes and should be adjusted accordingly.
                 if (recipe.name.count{ it == '.' } == 2) {

From aac8889582f42560a810f63174a052b2f048c5ea Mon Sep 17 00:00:00 2001
From: Mike Solomon <mike-solomon@users.noreply.github.com>
Date: Thu, 3 Oct 2024 10:12:37 -0700
Subject: [PATCH 11/17] Handle C# better

---
 .../kotlin/org/openrewrite/RecipeMarkdownGenerator.kt    | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
index f6b83a4..9d025d1 100644
--- a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
+++ b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
@@ -713,7 +713,14 @@ class RecipeMarkdownGenerator : Runnable {
          */
         private fun categoryIndex(): String {
             return StringBuilder().apply {
-                appendLine("# $displayName")
+                // Docusaurus gets confused when parsing C# as the sidebar title. We need to surround it in backticks
+                // so it displays correctly.
+                if (displayName == "C#") {
+                    appendLine("# `C#`")
+                } else {
+                    appendLine("# $displayName")
+                }
+
                 // While the description is not _supposed_ to be nullable it has happened before
                 @Suppress("SENSELESS_COMPARISON")
                 if (descriptor != null && descriptor.description != null) {

From 6ab9a7de18bb3cf437a9157ba4ce56d8f3d8a305 Mon Sep 17 00:00:00 2001
From: Mike Solomon <mike-solomon@users.noreply.github.com>
Date: Fri, 4 Oct 2024 09:01:13 -0700
Subject: [PATCH 12/17] Fix labeling

I was using title= instead of label= which made capitalization wrong.
I also didn't follow the pattern of fooBar and instead was doing foo-bar.
Both have been fixed
---
 .../openrewrite/RecipeMarkdownGenerator.kt    | 52 ++++++++++---------
 1 file changed, 28 insertions(+), 24 deletions(-)

diff --git a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
index 9d025d1..b5d0aab 100644
--- a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
+++ b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
@@ -717,7 +717,11 @@ class RecipeMarkdownGenerator : Runnable {
                 // so it displays correctly.
                 if (displayName == "C#") {
                     appendLine("# `C#`")
-                } else {
+                // Ai is not capitalized by default - so let's switch it to be AI
+                } else if (displayName == "Ai") {
+                    appendLine("# AI")
+                }
+                else {
                     appendLine("# $displayName")
                 }
 
@@ -1125,8 +1129,8 @@ import TabItem from '@theme/TabItem';
                     if (hasChange && source.before != null) {
                         newLine()
                         val tabName = source.path ?: (source.language ?: "Before / After")
-                        writeln("<Tabs groupId=\"before-after\">")
-                        writeln("<TabItem value=\"${tabName}\" title=\"${tabName}\">")
+                        writeln("<Tabs groupId=\"beforeAfter\">")
+                        writeln("<TabItem value=\"${tabName}\" label=\"${tabName}\">")
                     }
 
                     newLine()
@@ -1168,7 +1172,7 @@ import TabItem from '@theme/TabItem';
                         // diff
                         if (source.before != null) {
                             writeln("</TabItem>")
-                            writeln("<TabItem value=\"diff\" title=\"Diff\" >")
+                            writeln("<TabItem value=\"diff\" label=\"Diff\" >")
 
                             val diff = generateDiff(source.path, source.before, source.after)
 
@@ -1309,8 +1313,8 @@ import TabItem from '@theme/TabItem';
                         
                         ## Definition
                         
-                        <Tabs groupId="recipe-type">
-                        <TabItem value="recipe-list" title="Recipe List" >
+                        <Tabs groupId="recipeType">
+                        <TabItem value="recipe-list" label="Recipe List" >
                     """.trimIndent()
             )
             val recipeDepth = getRecipePath(recipeDescriptor).chars().filter { ch: Int -> ch == '/'.code }.count()
@@ -1347,7 +1351,7 @@ import TabItem from '@theme/TabItem';
                 """
                         </TabItem>
     
-                        <TabItem value="yaml-recipe-list" title="Yaml Recipe List">
+                        <TabItem value="yaml-recipe-list" label="Yaml Recipe List">
                         ```yaml
                     """.trimIndent()
             )
@@ -1457,7 +1461,7 @@ import TabItem from '@theme/TabItem';
         }
 
         return """
-                <TabItem value="moderne-cli" title="Moderne CLI">
+                <TabItem value="moderne-cli" label="Moderne CLI">
                     You will need to have configured the [Moderne CLI](https://docs.moderne.io/moderne-cli/cli-intro) on your machine before you can run the following command.
     
                     ```shell title="shell"
@@ -1477,7 +1481,7 @@ import TabItem from '@theme/TabItem';
         dataTableSnippet: String,
     ) {
         val gradleSnippet = if (suppressGradle) "" else """
-                            <TabItem value="gradle" title="Gradle">
+                            <TabItem value="gradle" label="Gradle">
                                 1. Add the following to your `build.gradle` file:
                                 ```groovy title="build.gradle"
                                 plugins {
@@ -1498,7 +1502,7 @@ import TabItem from '@theme/TabItem';
                             """.trimIndent()
 
         val mavenSnippet = if (suppressMaven) "" else """
-                            <TabItem value="maven" title="Maven">
+                            <TabItem value="maven" label="Maven">
                                 1. Add the following to your `pom.xml` file:
                                 ```xml title="pom.xml"
                                 <project>
@@ -1526,7 +1530,7 @@ import TabItem from '@theme/TabItem';
         writeln(
             """
 Now that `$exampleRecipeName` has been defined, activate it in your build file:
-<Tabs groupId="project-type">
+<Tabs groupId="projectType">
 $gradleSnippet
 $mavenSnippet
 $cliSnippet
@@ -1546,7 +1550,7 @@ $cliSnippet
         dataTableSnippet: String,
     ) {
         val gradleSnippet = if (suppressGradle) "" else """
-                            <TabItem value="gradle" title="Gradle">
+                            <TabItem value="gradle" label="Gradle">
                                 1. Add the following to your `build.gradle` file:
                                 ```groovy title="build.gradle"
                                 plugins {
@@ -1571,7 +1575,7 @@ $cliSnippet
                             """.trimIndent()
 
         val mavenSnippet = if (suppressMaven) "" else """
-                            <TabItem value="maven" title="Maven">
+                            <TabItem value="maven" label="Maven">
                                 1. Add the following to your `pom.xml` file:
                                 ```xml title="pom.xml"
                                 <project>
@@ -1606,7 +1610,7 @@ $cliSnippet
         writeln(
             """
 Now that `$exampleRecipeName` has been defined, activate it and take a dependency on ${origin.groupId}:${origin.artifactId}:${origin.version} in your build file:
-<Tabs groupId="project-type">
+<Tabs groupId="projectType">
 $gradleSnippet
 $mavenSnippet
 $cliSnippet
@@ -1631,7 +1635,7 @@ $cliSnippet
         )
 
         val gradleSnippet = if (suppressGradle) "" else """
-                            <TabItem value="gradle" title="Gradle">
+                            <TabItem value="gradle" label="Gradle">
                                 1. Add the following to your `build.gradle` file:
                                 ```groovy title="build.gradle"
                                 plugins {
@@ -1651,7 +1655,7 @@ $cliSnippet
                                 2. Run `gradle rewriteRun` to run the recipe.
                             </TabItem>
                             
-                            <TabItem value="gradle-init-script" title="Gradle init script">
+                            <TabItem value="gradle-init-script" label="Gradle init script">
                                 1. Create a file named `init.gradle` in the root of your project.
                                 ```groovy title="init.gradle"
                                 initscript {
@@ -1686,7 +1690,7 @@ $cliSnippet
                             """.trimIndent()
 
         val mavenSnippet = if (suppressMaven) "" else """
-                            <TabItem value="maven" title="Maven POM">
+                            <TabItem value="maven" label="Maven POM">
                                 1. Add the following to your `pom.xml` file:
                                 ```xml title="pom.xml"
                                 <project>
@@ -1710,7 +1714,7 @@ $cliSnippet
                                 2. Run `mvn rewrite:run` to run the recipe.
                             </TabItem>
                             
-                            <TabItem value="maven-command-line" title="Maven Command Line">
+                            <TabItem value="maven-command-line" label="Maven Command Line">
                                 You will need to have [Maven](https://maven.apache.org/download.cgi) installed on your machine before you can run the following command.
     
                                 ```shell title="shell"
@@ -1720,7 +1724,7 @@ $cliSnippet
                             """.trimIndent()
         writeln(
             """
-<Tabs groupId="project-type">
+<Tabs groupId="projectType">
 $gradleSnippet
 $mavenSnippet
 $cliSnippet
@@ -1747,7 +1751,7 @@ $cliSnippet
         )
 
         val gradleSnippet = if (suppressGradle) "" else """
-                            <TabItem value="gradle" title="Gradle">
+                            <TabItem value="gradle" label="Gradle">
                                 1. Add the following to your `build.gradle` file:
                                 ```groovy title="build.gradle"
                                 plugins {
@@ -1770,7 +1774,7 @@ $cliSnippet
                                 2. Run `gradle rewriteRun` to run the recipe.
                             </TabItem>
                             
-                            <TabItem value="gradle-init-script" title="Gradle init script">
+                            <TabItem value="gradle-init-script" label="Gradle init script">
                                 1. Create a file named `init.gradle` in the root of your project.
                                 ```groovy title="init.gradle"
                                 initscript {
@@ -1805,7 +1809,7 @@ $cliSnippet
                             """.trimIndent()
 
         val mavenSnippet = if (suppressMaven) "" else """
-                            <TabItem value="maven" title="Maven POM">
+                            <TabItem value="maven" label="Maven POM">
                                 1. Add the following to your `pom.xml` file:
                                 ```xml title="pom.xml"
                                 <project>
@@ -1836,7 +1840,7 @@ $cliSnippet
                                 2. Run `mvn rewrite:run` to run the recipe.
                             </TabItem>
                             
-                            <TabItem value="maven-command-line" title="Maven Command Line">
+                            <TabItem value="maven-command-line" label="Maven Command Line">
                                 You will need to have [Maven](https://maven.apache.org/download.cgi) installed on your machine before you can run the following command.
     
                                 ```shell title="shell"
@@ -1847,7 +1851,7 @@ $cliSnippet
 
         writeln(
             """
-<Tabs groupId="project-type">
+<Tabs groupId="projectType">
 $gradleSnippet
 $mavenSnippet
 $cliSnippet

From 0c4a81a7a00de34a7f1807c097e8fb1093ac05a5 Mon Sep 17 00:00:00 2001
From: Mike Solomon <mike-solomon@users.noreply.github.com>
Date: Fri, 4 Oct 2024 09:16:16 -0700
Subject: [PATCH 13/17] More style fixes

---
 .../openrewrite/RecipeMarkdownGenerator.kt    | 507 ++++++++++--------
 1 file changed, 269 insertions(+), 238 deletions(-)

diff --git a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
index b5d0aab..1242846 100644
--- a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
+++ b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
@@ -1130,7 +1130,7 @@ import TabItem from '@theme/TabItem';
                         newLine()
                         val tabName = source.path ?: (source.language ?: "Before / After")
                         writeln("<Tabs groupId=\"beforeAfter\">")
-                        writeln("<TabItem value=\"${tabName}\" label=\"${tabName}\">")
+                        writeln("<TabItem value=\"${tabName}\" label=\"${tabName}\">\n")
                     }
 
                     newLine()
@@ -1172,7 +1172,7 @@ import TabItem from '@theme/TabItem';
                         // diff
                         if (source.before != null) {
                             writeln("</TabItem>")
-                            writeln("<TabItem value=\"diff\" label=\"Diff\" >")
+                            writeln("<TabItem value=\"diff\" label=\"Diff\" >\n")
 
                             val diff = generateDiff(source.path, source.before, source.after)
 
@@ -1182,7 +1182,7 @@ import TabItem from '@theme/TabItem';
                                     |${diff}```
                                     """.trimMargin()
                             )
-                            writeln("  </TabItem>")
+                            writeln("</TabItem>")
                             writeln("</Tabs>")
                         }
                     }
@@ -1352,6 +1352,7 @@ import TabItem from '@theme/TabItem';
                         </TabItem>
     
                         <TabItem value="yaml-recipe-list" label="Yaml Recipe List">
+
                         ```yaml
                     """.trimIndent()
             )
@@ -1462,11 +1463,12 @@ import TabItem from '@theme/TabItem';
 
         return """
                 <TabItem value="moderne-cli" label="Moderne CLI">
-                    You will need to have configured the [Moderne CLI](https://docs.moderne.io/moderne-cli/cli-intro) on your machine before you can run the following command.
-    
-                    ```shell title="shell"
-                    mod run . --recipe $trimmedRecipeName
-                    ```
+
+                You will need to have configured the [Moderne CLI](https://docs.moderne.io/moderne-cli/cli-intro) on your machine before you can run the following command.
+
+                ```shell title="shell"
+                mod run . --recipe $trimmedRecipeName
+                ```
                 </TabItem>
         """.trimIndent()
     }
@@ -1482,48 +1484,51 @@ import TabItem from '@theme/TabItem';
     ) {
         val gradleSnippet = if (suppressGradle) "" else """
                             <TabItem value="gradle" label="Gradle">
-                                1. Add the following to your `build.gradle` file:
-                                ```groovy title="build.gradle"
-                                plugins {
-                                    id("org.openrewrite.rewrite") version("$gradlePluginVersion")
-                                }
-                                
-                                rewrite {
-                                    activeRecipe("$exampleRecipeName")
-                                    exportDatatables = true
-                                }
-                                
-                                repositories {
-                                    mavenCentral()
-                                }
-                                ```
-                                2. Run `gradle rewriteRun` to run the recipe.
+
+                            1. Add the following to your `build.gradle` file:
+                            ```groovy title="build.gradle"
+                            plugins {
+                                id("org.openrewrite.rewrite") version("$gradlePluginVersion")
+                            }
+                            
+                            rewrite {
+                                activeRecipe("$exampleRecipeName")
+                                exportDatatables = true
+                            }
+                            
+                            repositories {
+                                mavenCentral()
+                            }
+                            ```
+                            2. Run `gradle rewriteRun` to run the recipe.
                             </TabItem>
                             """.trimIndent()
 
         val mavenSnippet = if (suppressMaven) "" else """
                             <TabItem value="maven" label="Maven">
-                                1. Add the following to your `pom.xml` file:
-                                ```xml title="pom.xml"
-                                <project>
-                                  <build>
-                                    <plugins>
-                                      <plugin>
-                                        <groupId>org.openrewrite.maven</groupId>
-                                        <artifactId>rewrite-maven-plugin</artifactId>
-                                        <version>$mavenPluginVersion</version>
-                                        <configuration>
-                                          $dataTableSnippet
-                                          <activeRecipes>
-                                            <recipe>$exampleRecipeName</recipe>
-                                          </activeRecipes>
-                                        </configuration>
-                                      </plugin>
-                                    </plugins>
-                                  </build>
-                                </project>
-                                ```
-                                2. Run `mvn rewrite:run` to run the recipe.
+
+                            1. Add the following to your `pom.xml` file:
+
+                            ```xml title="pom.xml"
+                            <project>
+                              <build>
+                                <plugins>
+                                  <plugin>
+                                    <groupId>org.openrewrite.maven</groupId>
+                                    <artifactId>rewrite-maven-plugin</artifactId>
+                                    <version>$mavenPluginVersion</version>
+                                    <configuration>
+                                      $dataTableSnippet
+                                      <activeRecipes>
+                                        <recipe>$exampleRecipeName</recipe>
+                                      </activeRecipes>
+                                    </configuration>
+                                  </plugin>
+                                </plugins>
+                              </build>
+                            </project>
+                            ```
+                            2. Run `mvn rewrite:run` to run the recipe.
                             </TabItem>
                             """.trimIndent()
 
@@ -1551,59 +1556,63 @@ $cliSnippet
     ) {
         val gradleSnippet = if (suppressGradle) "" else """
                             <TabItem value="gradle" label="Gradle">
-                                1. Add the following to your `build.gradle` file:
-                                ```groovy title="build.gradle"
-                                plugins {
-                                    id("org.openrewrite.rewrite") version("$gradlePluginVersion")
-                                }
-                                
-                                rewrite {
-                                    activeRecipe("$exampleRecipeName")
-                                    exportDatatables = true
-                                }
-                                
-                                repositories {
-                                    mavenCentral()
-                                }
-                                
-                                dependencies {
-                                    rewrite("${origin.groupId}:${origin.artifactId}:${origin.version}")
-                                }
-                                ```
-                                2. Run `gradle rewriteRun` to run the recipe.
+
+                            1. Add the following to your `build.gradle` file:
+
+                            ```groovy title="build.gradle"
+                            plugins {
+                                id("org.openrewrite.rewrite") version("$gradlePluginVersion")
+                            }
+                            
+                            rewrite {
+                                activeRecipe("$exampleRecipeName")
+                                exportDatatables = true
+                            }
+                            
+                            repositories {
+                                mavenCentral()
+                            }
+                            
+                            dependencies {
+                                rewrite("${origin.groupId}:${origin.artifactId}:${origin.version}")
+                            }
+                            ```
+                            2. Run `gradle rewriteRun` to run the recipe.
                             </TabItem>
                             """.trimIndent()
 
         val mavenSnippet = if (suppressMaven) "" else """
                             <TabItem value="maven" label="Maven">
-                                1. Add the following to your `pom.xml` file:
-                                ```xml title="pom.xml"
-                                <project>
-                                  <build>
-                                    <plugins>
-                                      <plugin>
-                                        <groupId>org.openrewrite.maven</groupId>
-                                        <artifactId>rewrite-maven-plugin</artifactId>
-                                        <version>$mavenPluginVersion</version>
-                                        <configuration>
-                                          $dataTableSnippet
-                                          <activeRecipes>
-                                            <recipe>$exampleRecipeName</recipe>
-                                          </activeRecipes>
-                                        </configuration>
-                                        <dependencies>
-                                          <dependency>
-                                            <groupId>${origin.groupId}</groupId>
-                                            <artifactId>${origin.artifactId}</artifactId>
-                                            <version>${origin.version}</version>
-                                          </dependency>
-                                        </dependencies>
-                                      </plugin>
-                                    </plugins>
-                                  </build>
-                                </project>
-                                ```
-                                2. Run `mvn rewrite:run` to run the recipe.
+
+                            1. Add the following to your `pom.xml` file:
+
+                            ```xml title="pom.xml"
+                            <project>
+                              <build>
+                                <plugins>
+                                  <plugin>
+                                    <groupId>org.openrewrite.maven</groupId>
+                                    <artifactId>rewrite-maven-plugin</artifactId>
+                                    <version>$mavenPluginVersion</version>
+                                    <configuration>
+                                      $dataTableSnippet
+                                      <activeRecipes>
+                                        <recipe>$exampleRecipeName</recipe>
+                                      </activeRecipes>
+                                    </configuration>
+                                    <dependencies>
+                                      <dependency>
+                                        <groupId>${origin.groupId}</groupId>
+                                        <artifactId>${origin.artifactId}</artifactId>
+                                        <version>${origin.version}</version>
+                                      </dependency>
+                                    </dependencies>
+                                  </plugin>
+                                </plugins>
+                              </build>
+                            </project>
+                            ```
+                            2. Run `mvn rewrite:run` to run the recipe.
                             </TabItem>
                             """.trimIndent()
 
@@ -1636,90 +1645,101 @@ $cliSnippet
 
         val gradleSnippet = if (suppressGradle) "" else """
                             <TabItem value="gradle" label="Gradle">
-                                1. Add the following to your `build.gradle` file:
-                                ```groovy title="build.gradle"
-                                plugins {
-                                    id("org.openrewrite.rewrite") version("$gradlePluginVersion")
+
+                            1. Add the following to your `build.gradle` file:
+
+                            ```groovy title="build.gradle"
+                            plugins {
+                                id("org.openrewrite.rewrite") version("$gradlePluginVersion")
+                            }
+                            
+                            rewrite {
+                                activeRecipe("${recipeDescriptor.name}")
+                                exportDatatables = true
+                            }
+                            
+                            repositories {
+                                mavenCentral()
+                            }
+                            
+                            ```
+                            2. Run `gradle rewriteRun` to run the recipe.
+                            </TabItem>
+                            
+                            <TabItem value="gradle-init-script" label="Gradle init script">
+
+                            1. Create a file named `init.gradle` in the root of your project.
+
+                            ```groovy title="init.gradle"
+                            initscript {
+                                repositories {
+                                    maven { url "https://plugins.gradle.org/m2" }
+                                }
+                                dependencies { classpath("org.openrewrite:plugin:latest.release") }
+                            }
+                            rootProject {
+                                plugins.apply(org.openrewrite.gradle.RewritePlugin)
+                                dependencies {
+                                    rewrite("org.openrewrite:rewrite-java")
                                 }
-                                
                                 rewrite {
                                     activeRecipe("${recipeDescriptor.name}")
                                     exportDatatables = true
                                 }
-                                
-                                repositories {
-                                    mavenCentral()
-                                }
-                                
-                                ```
-                                2. Run `gradle rewriteRun` to run the recipe.
-                            </TabItem>
-                            
-                            <TabItem value="gradle-init-script" label="Gradle init script">
-                                1. Create a file named `init.gradle` in the root of your project.
-                                ```groovy title="init.gradle"
-                                initscript {
-                                    repositories {
-                                        maven { url "https://plugins.gradle.org/m2" }
-                                    }
-                                    dependencies { classpath("org.openrewrite:plugin:latest.release") }
-                                }
-                                rootProject {
-                                    plugins.apply(org.openrewrite.gradle.RewritePlugin)
-                                    dependencies {
-                                        rewrite("org.openrewrite:rewrite-java")
-                                    }
-                                    rewrite {
-                                        activeRecipe("${recipeDescriptor.name}")
-                                        exportDatatables = true
-                                    }
-                                    afterEvaluate {
-                                        if (repositories.isEmpty()) {
-                                            repositories {
-                                                mavenCentral()
-                                            }
+                                afterEvaluate {
+                                    if (repositories.isEmpty()) {
+                                        repositories {
+                                            mavenCentral()
                                         }
                                     }
                                 }
-                                ```
-                                2. Run the recipe.
-                                ```shell title="shell"
-                                gradle --init-script init.gradle rewriteRun
-                                ```
+                            }
+                            ```
+
+                            2. Run the recipe.
+
+                            ```shell title="shell"
+                            gradle --init-script init.gradle rewriteRun
+                            ```
                             </TabItem>
                             """.trimIndent()
 
         val mavenSnippet = if (suppressMaven) "" else """
                             <TabItem value="maven" label="Maven POM">
-                                1. Add the following to your `pom.xml` file:
-                                ```xml title="pom.xml"
-                                <project>
-                                  <build>
-                                    <plugins>
-                                      <plugin>
-                                        <groupId>org.openrewrite.maven</groupId>
-                                        <artifactId>rewrite-maven-plugin</artifactId>
-                                        <version>$mavenPluginVersion</version>
-                                        <configuration>
-                                          $dataTableSnippet
-                                          <activeRecipes>
-                                            <recipe>${recipeDescriptor.name}</recipe>
-                                          </activeRecipes>
-                                        </configuration>
-                                      </plugin>
-                                    </plugins>
-                                  </build>
-                                </project>
-                                ```
-                                2. Run `mvn rewrite:run` to run the recipe.
+
+                            1. Add the following to your `pom.xml` file:
+
+                            ```xml title="pom.xml"
+                            <project>
+                              <build>
+                                <plugins>
+                                  <plugin>
+                                    <groupId>org.openrewrite.maven</groupId>
+                                    <artifactId>rewrite-maven-plugin</artifactId>
+                                    <version>$mavenPluginVersion</version>
+                                    <configuration>
+                                      $dataTableSnippet
+                                      <activeRecipes>
+                                        <recipe>${recipeDescriptor.name}</recipe>
+                                      </activeRecipes>
+                                    </configuration>
+                                  </plugin>
+                                </plugins>
+                              </build>
+                            </project>
+                            ```
+
+                            2. Run `mvn rewrite:run` to run the recipe.
                             </TabItem>
                             
                             <TabItem value="maven-command-line" label="Maven Command Line">
-                                You will need to have [Maven](https://maven.apache.org/download.cgi) installed on your machine before you can run the following command.
-    
-                                ```shell title="shell"
-                                mvn -U org.openrewrite.maven:rewrite-maven-plugin:run -Drewrite.activeRecipes=${recipeDescriptor.name} $dataTableCommandLineSnippet
-                                ```
+
+                            You will need to have [Maven](https://maven.apache.org/download.cgi) installed on your machine before you can run the following command.
+
+                            ```shell title="shell"
+                            mvn -U org.openrewrite.maven:rewrite-maven-plugin:run -Drewrite.activeRecipes=${recipeDescriptor.name} $dataTableCommandLineSnippet
+                            ```
+
                             </TabItem>
                             """.trimIndent()
         writeln(
@@ -1752,100 +1772,111 @@ $cliSnippet
 
         val gradleSnippet = if (suppressGradle) "" else """
                             <TabItem value="gradle" label="Gradle">
-                                1. Add the following to your `build.gradle` file:
-                                ```groovy title="build.gradle"
-                                plugins {
-                                    id("org.openrewrite.rewrite") version("$gradlePluginVersion")
-                                }
-                                
-                                rewrite {
-                                    activeRecipe("${recipeDescriptor.name}")
-                                    exportDatatables = true
-                                }
-                                
+
+                            1. Add the following to your `build.gradle` file:
+
+                            ```groovy title="build.gradle"
+                            plugins {
+                                id("org.openrewrite.rewrite") version("$gradlePluginVersion")
+                            }
+                            
+                            rewrite {
+                                activeRecipe("${recipeDescriptor.name}")
+                                exportDatatables = true
+                            }
+                            
+                            repositories {
+                                mavenCentral()
+                            }
+                            
+                            dependencies {
+                                rewrite("${origin.groupId}:${origin.artifactId}:${origin.version}")
+                            }
+                            ```
+
+                            2. Run `gradle rewriteRun` to run the recipe.
+                            </TabItem>
+                            
+                            <TabItem value="gradle-init-script" label="Gradle init script">
+
+                            1. Create a file named `init.gradle` in the root of your project.
+
+                            ```groovy title="init.gradle"
+                            initscript {
                                 repositories {
-                                    mavenCentral()
+                                    maven { url "https://plugins.gradle.org/m2" }
                                 }
-                                
+                                dependencies { classpath("org.openrewrite:plugin:${gradlePluginVersion}") }
+                            }
+                            rootProject {
+                                plugins.apply(org.openrewrite.gradle.RewritePlugin)
                                 dependencies {
                                     rewrite("${origin.groupId}:${origin.artifactId}:${origin.version}")
                                 }
-                                ```
-                                2. Run `gradle rewriteRun` to run the recipe.
-                            </TabItem>
-                            
-                            <TabItem value="gradle-init-script" label="Gradle init script">
-                                1. Create a file named `init.gradle` in the root of your project.
-                                ```groovy title="init.gradle"
-                                initscript {
-                                    repositories {
-                                        maven { url "https://plugins.gradle.org/m2" }
-                                    }
-                                    dependencies { classpath("org.openrewrite:plugin:${gradlePluginVersion}") }
+                                rewrite {
+                                    activeRecipe("${recipeDescriptor.name}")
+                                    exportDatatables = true
                                 }
-                                rootProject {
-                                    plugins.apply(org.openrewrite.gradle.RewritePlugin)
-                                    dependencies {
-                                        rewrite("${origin.groupId}:${origin.artifactId}:${origin.version}")
-                                    }
-                                    rewrite {
-                                        activeRecipe("${recipeDescriptor.name}")
-                                        exportDatatables = true
-                                    }
-                                    afterEvaluate {
-                                        if (repositories.isEmpty()) {
-                                            repositories {
-                                                mavenCentral()
-                                            }
+                                afterEvaluate {
+                                    if (repositories.isEmpty()) {
+                                        repositories {
+                                            mavenCentral()
                                         }
                                     }
                                 }
-                                ```
-                                2. Run the recipe.
-                                ```shell title="shell"
-                                gradle --init-script init.gradle rewriteRun
-                                ```
+                            }
+                            ```
+
+                            2. Run the recipe.
+
+                            ```shell title="shell"
+                            gradle --init-script init.gradle rewriteRun
+                            ```
+
                             </TabItem>
                             """.trimIndent()
 
         val mavenSnippet = if (suppressMaven) "" else """
                             <TabItem value="maven" label="Maven POM">
-                                1. Add the following to your `pom.xml` file:
-                                ```xml title="pom.xml"
-                                <project>
-                                  <build>
-                                    <plugins>
-                                      <plugin>
-                                        <groupId>org.openrewrite.maven</groupId>
-                                        <artifactId>rewrite-maven-plugin</artifactId>
-                                        <version>$mavenPluginVersion</version>
-                                        <configuration>
-                                          $dataTableSnippet
-                                          <activeRecipes>
-                                            <recipe>${recipeDescriptor.name}</recipe>
-                                          </activeRecipes>
-                                        </configuration>
-                                        <dependencies>
-                                          <dependency>
-                                            <groupId>${origin.groupId}</groupId>
-                                            <artifactId>${origin.artifactId}</artifactId>
-                                            <version>${origin.version}</version>
-                                          </dependency>
-                                        </dependencies>
-                                      </plugin>
-                                    </plugins>
-                                  </build>
-                                </project>
-                                ```
-                                2. Run `mvn rewrite:run` to run the recipe.
+
+                            1. Add the following to your `pom.xml` file:
+
+                            ```xml title="pom.xml"
+                            <project>
+                              <build>
+                                <plugins>
+                                  <plugin>
+                                    <groupId>org.openrewrite.maven</groupId>
+                                    <artifactId>rewrite-maven-plugin</artifactId>
+                                    <version>$mavenPluginVersion</version>
+                                    <configuration>
+                                      $dataTableSnippet
+                                      <activeRecipes>
+                                        <recipe>${recipeDescriptor.name}</recipe>
+                                      </activeRecipes>
+                                    </configuration>
+                                    <dependencies>
+                                      <dependency>
+                                        <groupId>${origin.groupId}</groupId>
+                                        <artifactId>${origin.artifactId}</artifactId>
+                                        <version>${origin.version}</version>
+                                      </dependency>
+                                    </dependencies>
+                                  </plugin>
+                                </plugins>
+                              </build>
+                            </project>
+                            ```
+
+                            2. Run `mvn rewrite:run` to run the recipe.
                             </TabItem>
                             
                             <TabItem value="maven-command-line" label="Maven Command Line">
-                                You will need to have [Maven](https://maven.apache.org/download.cgi) installed on your machine before you can run the following command.
-    
-                                ```shell title="shell"
-                                mvn -U org.openrewrite.maven:rewrite-maven-plugin:run -Drewrite.recipeArtifactCoordinates=${origin.groupId}:${origin.artifactId}:RELEASE -Drewrite.activeRecipes=${recipeDescriptor.name} $dataTableCommandLineSnippet
-                                ```
+                            You will need to have [Maven](https://maven.apache.org/download.cgi) installed on your machine before you can run the following command.
+
+                            ```shell title="shell"
+                            mvn -U org.openrewrite.maven:rewrite-maven-plugin:run -Drewrite.recipeArtifactCoordinates=${origin.groupId}:${origin.artifactId}:RELEASE -Drewrite.activeRecipes=${recipeDescriptor.name} $dataTableCommandLineSnippet
+                            ```
                             </TabItem>
                             """.trimIndent()
 

From 913ead824d7b48a563313c2a2f397666917f4731 Mon Sep 17 00:00:00 2001
From: Mike Solomon <mike-solomon@users.noreply.github.com>
Date: Mon, 7 Oct 2024 09:06:13 -0700
Subject: [PATCH 14/17] Fix recipes with data tables

---
 .../kotlin/org/openrewrite/RecipeMarkdownGenerator.kt | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
index 1242846..121f82a 100644
--- a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
+++ b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
@@ -304,7 +304,16 @@ class RecipeMarkdownGenerator : Runnable {
                     "it won't be included in this list._\n")
 
             for (recipe in recipesWithDataTables) {
-                writeln("### [${recipe.displayName}](https://docs.openrewrite.org/?q=${recipe.name})\n ")
+                var recipePath = "";
+
+                if (recipe.name.count { it == '.' } == 2 &&
+                    recipe.name.contains("org.openrewrite.")) {
+                    recipePath = "recipes/core/" + recipe.name.removePrefix("org.openrewrite.");
+                } else {
+                    recipePath = "recipes/" + recipe.name.removePrefix("org.openrewrite.").replace(".", "/").lowercase();
+                }
+
+                writeln("### [${recipe.displayName}](/${recipePath})\n ")
                 writeln("_${recipe.name}_\n")
                 writeln("${recipe.description}\n")
                 writeln("#### Data tables:\n")

From 0fa9a439583b585437c5d82efda523c383b2f89d Mon Sep 17 00:00:00 2001
From: Mike Solomon <mike-solomon@users.noreply.github.com>
Date: Mon, 7 Oct 2024 10:57:45 -0700
Subject: [PATCH 15/17] Handle HTML better + fix datatables further

---
 .../openrewrite/RecipeMarkdownGenerator.kt    | 27 ++++++++++---------
 1 file changed, 14 insertions(+), 13 deletions(-)

diff --git a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
index 121f82a..10869f7 100644
--- a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
+++ b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
@@ -308,9 +308,9 @@ class RecipeMarkdownGenerator : Runnable {
 
                 if (recipe.name.count { it == '.' } == 2 &&
                     recipe.name.contains("org.openrewrite.")) {
-                    recipePath = "recipes/core/" + recipe.name.removePrefix("org.openrewrite.");
+                    recipePath = "docs/recipes/core/" + recipe.name.removePrefix("org.openrewrite.").lowercase();
                 } else {
-                    recipePath = "recipes/" + recipe.name.removePrefix("org.openrewrite.").replace(".", "/").lowercase();
+                    recipePath = "docs/recipes/" + recipe.name.removePrefix("org.openrewrite.").replace(".", "/").lowercase();
                 }
 
                 writeln("### [${recipe.displayName}](/${recipePath})\n ")
@@ -888,17 +888,7 @@ class RecipeMarkdownGenerator : Runnable {
             ?.replace(">", "&gt;")
             ?.trim()
 
-        val formattedRecipeDescription = "_" +
-                recipeDescriptor?.description
-                    ?.replace("`<", "&lt;")
-                    ?.replace(">`", "&gt;")
-                    ?.replace("<", "&lt;")
-                    ?.replace(">", "&gt;")
-                    ?.replace("{", "&lcub;")
-                    ?.replace("}", "&rcub;")
-                    ?.replace("\n", " ")
-                    ?.trim() +
-                    "_"
+        val formattedRecipeDescription = getFormattedRecipeDescription(recipeDescriptor)
 
         val formattedLongRecipeName = recipeDescriptor.name.replace("_".toRegex(), "\\\\_").trim()
 
@@ -953,6 +943,17 @@ import TabItem from '@theme/TabItem';
         }
     }
 
+    private fun getFormattedRecipeDescription(recipeDescriptor: RecipeDescriptor): String {
+        val specialCharacters = listOf('<', '>', '{', '}')
+        val formattedRecipeDescription = recipeDescriptor?.description
+
+        if (specialCharacters.any { recipeDescriptor?.description?.contains(it) == true } ) {
+            return "```\n${formattedRecipeDescription?.replace("```", "")?.trim()}\n```\n"
+        } else {
+            return "_" + formattedRecipeDescription?.replace("\n", " ")?.trim() + "_"
+        }
+    }
+
     private fun BufferedWriter.writeSourceLinks(recipeDescriptor: RecipeDescriptor, origin: RecipeOrigin) {
         writeln(
             """

From 4cd1051b25ca578c8410face3c4321dde6749840 Mon Sep 17 00:00:00 2001
From: Mike Solomon <mike-solomon@users.noreply.github.com>
Date: Mon, 7 Oct 2024 11:26:54 -0700
Subject: [PATCH 16/17] Really fix datatables hopefully

---
 src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
index 10869f7..0325422 100644
--- a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
+++ b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
@@ -308,12 +308,12 @@ class RecipeMarkdownGenerator : Runnable {
 
                 if (recipe.name.count { it == '.' } == 2 &&
                     recipe.name.contains("org.openrewrite.")) {
-                    recipePath = "docs/recipes/core/" + recipe.name.removePrefix("org.openrewrite.").lowercase();
+                    recipePath = "recipes/core/" + recipe.name.removePrefix("org.openrewrite.").lowercase();
                 } else {
-                    recipePath = "docs/recipes/" + recipe.name.removePrefix("org.openrewrite.").replace(".", "/").lowercase();
+                    recipePath = "recipes/" + recipe.name.removePrefix("org.openrewrite.").replace(".", "/").lowercase();
                 }
 
-                writeln("### [${recipe.displayName}](/${recipePath})\n ")
+                writeln("### [${recipe.displayName}](../${recipePath})\n ")
                 writeln("_${recipe.name}_\n")
                 writeln("${recipe.description}\n")
                 writeln("#### Data tables:\n")

From 691fd4207ba78c5d999e92b4c89a8748a9b371cb Mon Sep 17 00:00:00 2001
From: Mike Solomon <mike-solomon@users.noreply.github.com>
Date: Mon, 7 Oct 2024 11:57:36 -0700
Subject: [PATCH 17/17] Handle AI data tables

---
 src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
index 0325422..45476d9 100644
--- a/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
+++ b/src/main/kotlin/org/openrewrite/RecipeMarkdownGenerator.kt
@@ -309,6 +309,8 @@ class RecipeMarkdownGenerator : Runnable {
                 if (recipe.name.count { it == '.' } == 2 &&
                     recipe.name.contains("org.openrewrite.")) {
                     recipePath = "recipes/core/" + recipe.name.removePrefix("org.openrewrite.").lowercase();
+                } else if (recipe.name.contains("io.moderne.ai")) {
+                    recipePath = "recipes/ai/" + recipe.name.removePrefix("io.moderne.ai.").replace(".", "/").lowercase();
                 } else {
                     recipePath = "recipes/" + recipe.name.removePrefix("org.openrewrite.").replace(".", "/").lowercase();
                 }