Migrate to Dokka2

.github/workflows/prepare_mkdocs.sh

@@ -9,7 +9,7 @@
 set -ex
 
 # Generate the API docs
-./gradlew dokkaGfm
+./gradlew dokkaGenerate
 
 # Dokka filenames like `-http-url/index.md` don't work well with MkDocs <title> tags.
 # Assign metadata to the file's first Markdown heading.

gradle.properties

@@ -28,3 +28,7 @@ android.suppressUnsupportedCompileSdk=UpsideDownCakePrivacySandbox
 
 # Signals to our own plugin that we are building within the repo.
 app.cash.paparazzi.internal=true
+
+# Dokka
+org.jetbrains.dokka.experimental.gradle.pluginMode=V2Enabled
+org.jetbrains.dokka.experimental.gradle.pluginMode.noWarn=true

paparazzi/build.gradle

@@ -73,18 +73,19 @@ dependencies {
   testImplementation libs.truth
 }
 
-tasks.named("dokkaGfm").configure {
-  outputDirectory = rootProject.file("docs/1.x")
+dokka {
+  dokkaPublications.configureEach {
+    outputDirectory.set(rootProject.file("docs/1.x"))
+  }
+
+  dokkaSourceSets.main {
+    reportUndocumented = false
+    skipDeprecated = true
+    jdkVersion = 17
 
-  dokkaSourceSets.named("main") {
-    configureEach {
-      reportUndocumented = false
-      skipDeprecated = true
-      jdkVersion = 8
-      perPackageOption {
-        prefix = "app.cash.paparazzi.internal"
-        suppress = true
-      }
+    perPackageOption {
+      matchingRegex = "app.cash.paparazzi.internal.*"
+      suppress = true
     }
   }
 }